Share via

3.7.4.1.3 RpcIcaServerPing (Opnum 2)

  • Article

The RpcIcaServerPing method is called to verify that the server is alive. No special permissions are required to call this method.<159>

 BOOLEAN RpcIcaServerPing(
   [in] SERVER_HANDLE hServer,
   [out] DWORD* pResult
 );

hServer: Handle to the server object. This is of type SERVER_HANDLE. The hServer argument MUST be obtained from a previous call to RpcWinStationOpenServer.

pResult: If the call was successful, this parameter is STATUS_SUCCESS (0x00000000), as specified in [MS-ERREF]; otherwise it MUST be an implementation-specific negative value.

Return Values:  Returns TRUE if the call succeeded and the server is alive, or FALSE if the method failed. On failure, pResult indicates the failure status code.

Return value/code

Description

0x01

TRUE

Successful completion.

0x00

FALSE

Method call failed.