RpcMgmtIsServerListening

The RpcMgmtIsServerListening function tells whether a server is listening for remote procedure calls.

This function is supported by both 32-bit platforms — Windows NT and Windows 95.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtIsServerListening( 
  RPC_BINDING_HANDLE  Binding  
);

Parameters

Binding
To determine whether a remote application is listening for remote procedure calls, specify a server binding handle for that application. To determine whether your own (local) application is listening for remote procedure calls, specify a value of NULL.

Remarks

An application calls the RpcMgmtIsServerListening routine to determine whether the server specified in the Binding argument is listening for remote procedure calls.

RpcMgmtIsServerListening returns a true value if the server has called the RpcServerListen routine.

Return Values

Value Meaning
RPC_S_OK Server listening for remote procedure calls
RPC_S_SERVER_NOT_LISTENING Server not listening for remote procedure calls
RPC_S_INVALID_BINDING Invalid binding handle
RPC_S_WRONG_KIND_OF_BINDING Wrong kind of binding for operation

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcEpResolveBinding, RpcServerListen