PrlApi_GetSupportedOsesVersions Function

Returns handle of type PHT_OPAQUE_TYPE_LIST which contains supported guest OSes list for specified guest OS type at current API mode (see PrlApi_InitEx for more info about API mode).

Syntax

PRL_RESULT PrlApi_GetSupportedOsesVersions(
    PRL_HOST_OS_TYPE nHostOsType, 
    PRL_UINT8 nGuestOsType, 
    PRL_HANDLE_PTR phGuestsList
);

File

PrlApiVm.h

Parameters

nHostOsType

type of host system (remote or local) for which supported OSes list should be retrieved. In remote work mode please determine at first remote side host type (please use PrlSrvCfg_GetHostOsType for this). In local work mode PHO_UNKNOWN can be passed - host OS type will be automatically detected by API call in this case.

nGuestOsType

requesting guest OS type. In order to determine list of supported guests types please refer PrlOses.h

phOsesTypesList

[out] A pointer to a variable that receives the handle.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - null pointer or unknown OS type was passed.

PRL_ERR_OUT_OF_MEMORY - not enough memory to create the list object.

PRL_ERR_SUCCESS - function completed successfully.

Links

System Functions