PrlSrv_CheckParallelsServerAliveEx Function

The same functionality as previos version of call except follow things:

provides asynch interface;
using TCP connection instead of UDP.

Syntax

PRL_HANDLE PrlSrv_CheckParallelsServerAliveEx(
    PRL_CONST_STR sServerHostname, 
    PRL_UINT16 nServerPort, 
    PRL_UINT32 timeout, 
    PRL_EVENT_HANDLER_PTR pUserCallback, 
    PRL_VOID_PTR pUserData, 
    PRL_UINT32 nReserved
);

File

PrlApi.h

Parameters

sServerHostname

The name of the host machine for which to get the Parallels Service status. The parameter can't be empty or null.

nServerPort

listen port to check. Can be 0 - default Parallels Service port will be used in this case.

timeout

Timeout in milliseconds specifying how long the function should wait for a response from the Parallels Service.

pUserCallback

user callback for asynch work mode.

pUserData

user data which will be passed into the user callback.

nReserved

reserved parameter for further purposes.

Returns

PRL_RESULT . Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer (excluding those that can be null) was passed.

PRL_ERR_SUCCESS - function completed successfully.

Links

PrlApi.h , PHT_SERVER