Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVm_InstallTools Function
PHT_VIRTUAL_MACHINE

Begin the Parallels Tools installation process.

Syntax
PRL_HANDLE PrlVm_InstallTools(
    PRL_HANDLE hVm
);
File

PrlApiVm.h

Parameters

handle
A handle of type PHT_VIRTUAL_MACHINE identifying the virtual machine.

Returns

PRL_HANDLE to job that describing async operation result (PRL_INVALID_HANDLE means not enough memory to instantiate async job represents object handle). Operation return code can be extracted with @ref PrlJob_GetRetCode() call. Possible values: PRL_ERR_INVALID_ARG - non valid PHT_VIRTUAL_MACHINE handle was passed PRL_ERR_UNINITIALIZED - unexpected error: uninitialized with Parallels Service connection or non identified VM object

Remarks

The machine must be registered with the Parallels Service to perform this operation.

Links
© 2021 Parallels International GmbH. All rights reserved.