8.2.10 OleUnblockServer

OLESTATUS OleUnblockServer(lhSrvr, lpfRequest)

LHSERVER lhSrvr;

BOOL FAR * lpfRequest;

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

Parameter Description

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.

A server application can use the OleBlockServer and OleUnblockServer functions to control when the server DLL processes requests from client applications. The best way to use the OleUnblockServer function is 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-supplied functions that are called by the DLL.

The return value is OLE_OK if successful; otherwise, it could be one of the following:

OLE_ERROR_HANDLE

OLE_ERROR_MEMORY

See AlsoOleBlockServer