RpcMgmtWaitServerListen

The RpcMgmtWaitServerListen function performs the wait operation usually associated with RpcServerListen.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtWaitServerListen(VOID);

Remarks

Note  RpcMgmtWaitServerListen is a Microsoft extension to the DCE API set.

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

When the RpcServerListen flag parameter DontWait has a nonzero value, the RpcServerListen function returns to the server application without performing the wait operation. In this case, the wait can be performed by RpcMgmtWaitServerListen.

Applications must call RpcServerListen with a nonzero value for the DontWait parameter before calling RpcMgmtWaitServerListen.

RpcMgmtWaitServerListen returns after the server application calls RpcMgmtStopServerListening and all active remote procedure calls complete, or after a fatal error occurs in the RPC run-time library.

Return Values

Value Meaning
RPC_S_OK All remote procedure calls are complete.
RPC_S_ALREADY_LISTENING Another thread has called RpcMgmtWaitServerListen and has not yet returned.
RPC_S_NOT_LISTENING The server application must call RpcServerListen before calling RpcMgmtWaitServerListen.

QuickInfo

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

See Also

RpcMgmtStopServerListening, RpcServerListen