RpcMgmtWaitServerListen function (rpcdce.h)

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

Syntax

RPC_STATUS RpcMgmtWaitServerListen();

Return value

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.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

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. The RpcMgmtWaitServerListen function 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.

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

See also

RpcMgmtStopServerListening

RpcServerListen