Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlSrv_GetSupportedOses Function
PHT_SERVER

Extracts supported guest OSes matrix from remote server (it's more proper way instead of using local synch API in case when client and server interoperate remotely).

Syntax
PRL_RESULT PrlSrv_GetSupportedOses(
    PRL_HANDLE hServer, 
    PRL_HANDLE_PTR phOsesMatrix
);
File

PrlApiVm.h

Parameters

hServer
A handle of type PHT_SERVER identifying the Parallels Service.
phOsesMatrix
pointer to the buffer for storing result.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed. PRL_ERR_NO_DATA - no supported OSes data (OSes matrix filling just after login procedure completed). Also this field can be empty in case when remote server is not supported this interface. 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

 

To get the return code from the PHT_JOB object, use the PrlJob_GetRetCode function. Possible values are: 

PRL_ERR_INVALID_ARG - invalid handle was passed. 

PRL_ERR_SUCCESS - function completed successfully. 

To get the results from the PHT_JOB object:

  1. Use the PrlJob_GetResult function to obtain a handle to the PHT_RESULT object.
  2. Use the PrlResult_GetParam function to obtain a handle of type PHT_GUEST_OSES_MATRIX which will contain complete list of supported guest OSes types, versions and defaults.
Links
© 2021 Parallels International GmbH. All rights reserved.