PrlVmCfg_GetSearchDomains Function

Obtains the list of globally defined search domains that will be assigned to a virtual machine on the guest operating system side.

Syntax

PRL_RESULT PrlVmCfg_GetSearchDomains(
    PRL_HANDLE hVmCfg, 
    PRL_HANDLE_PTR phSearchDomainsList
);

PrlApiVm.h

hVmCfg

A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.

phSearchDomainsList

[out] A pointer to the PHT_STRINGS_LIST handle containing the list of search domains.

PRL_RESULT. Possible values are:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_OUT_OF_MEMORY - not enough memory to allocate the string list object.

PRL_ERR_SUCCESS - function completed successfully.