OleRevokeServerDoc

  OLESTATUS OleRevokeServerDoc(lhdoc)    
  LHSERVERDOC lhdoc; /* document handle */

The OleRevokeServerDoc function revokes the specified document. A server application calls this function when a registered document is being closed or otherwise made unavailable to client applications.

Parameters

lhdoc

Identifies the document to revoke. This handle was returned by a call to the OleRegisterServerDoc function or was associated with a document by using one of the server-supplied functions that create documents.

Return Value

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

Comments

If this function returns OLE_WAIT_FOR_RELEASE, the server application should not free the OLESERVERDOC structure or exit until it receives an OLE_RELEASE notification from the library.

See Also

OleRegisterServerDoc, OleRevokeObject, OleRevokeServer