OleBlockServer

3.1

  #include <ole.h>    

  OLESTATUS OleBlockServer(lhSrvr)    
  LHSERVER lhSrvr; /* handle of server, */  

The OleBlockServer function causes requests to the server to be queued until the server calls the OleUnblockServer function.

Parameters

lhSrvr

Identifies the server for which requests are to be queued.

Return Value

The return value is OLE_OK if the function is successful. Otherwise, it is an error value, which may be OLE_ERROR_HANDLE.

Comments

The server must call the OleUnblockServer function after calling the OleBlockServer function.

A server application can use the OleBlockServer and OleUnblockServer functions to control when the server library processes requests from client applications. Because only messages from the client to the server are blocked, a blocked server can continue to send messages to client applications.

A server application receives a handle when it calls the OleRegisterServer function.

See Also

OleRegisterServer, OleUnblockServer