PrlSrvCfg_GetSearchDomains Function

Obtains the list of search domains for the specified host or guest.

Syntax

PRL_RESULT PrlSrvCfg_GetSearchDomains(
    PRL_HANDLE hSrvConfig, 
    PRL_HANDLE_PTR phSearchDomainsList
);

PrlApiDisp.h

phSearchDomainsList

[out] A pointer to a variable that receives the PHT_STRINGS_LIST handle containing the list of search domains.

hNetAdapter

A handle of type PHT_SERVER_CONFIG. When obtaining the host OS information, use the PrlSrv_GetSrvConfig to obtain the handle. When obtaining the guest OS information, use the PrlVmGuest_GetNetworkSettings function.

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_OUT_OF_MEMORY - not enough memory to instantiate strings list object

PRL_ERR_SUCCESS - function completed successfully.