PrlVm_InstallTools Function

Begin the Parallels Tools installation process.

Syntax

PRL_HANDLE PrlVm_InstallTools(
    PRL_HANDLE hVm
);

File

PrlApi.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

PrlApi.h, PHT_VIRTUAL_MACHINE