OleUnblockServer

3.1

  #include <ole.h>    

  OLESTATUS OleUnblockServer(lhSrvr, lpfRequest)    
  LHSERVER lhSrvr; /* handle of server, */  
  BOOL FAR* lpfRequest; /* address of flag for more requests */

The OleUnblockServer function processes a request from a queue created by calling the OleBlockServer function.

Parameters

lhSrvr

Identifies the server for which requests were queued.

lpfRequest

Points to a flag indicating whether there are further requests in the queue. If there are further requests in the queue, this flag is TRUE when the function returns. Otherwise, it is FALSE when the function returns.

Return Value

The return value is OLE_OK if the function is successful. Otherwise, it is an error value, which may be one of the following:

OLE_ERROR_HANDLE OLE_ERROR_MEMORY

Comments

A server application can use the OleBlockServer and OleUnblockServer functions to control when the server library processes requests from client applications. It is best to use OleUnblockServer outside the GetMessage function in a message loop, unblocking all blocked messages before getting the next message. Unblocking message loops should not be run inside server-defined functions that are called by the library.

See Also

OleBlockServer