| #include <ole.h> |
| OLE_RELEASE_METHOD OleQueryReleaseMethod(lpobj) | |||||
| LPOLEOBJECT lpobj; | /* address of object to query | */ | |||
The OleQueryReleaseMethod function finds out the operation that finished for the specified object.
lpobj
Points to an object for which the operation is to be queried.
The return value indicates the server operation (method) that finished. It can be one of the following values:
| Value | Server operation |
| OLE_ACTIVATE | Activate |
| OLE_CLOSE | Close |
| OLE_COPYFROMLNK | CopyFromLink (autoreconnect) |
| OLE_CREATE | Create |
| OLE_CREATEFROMFILE | CreateFromFile |
| OLE_CREATEFROMTEMPLATE | CreateFromTemplate |
| OLE_CREATEINVISIBLE | CreateInvisible |
| OLE_CREATELINKFROMFILE | CreateLinkFromFile |
| OLE_DELETE | Object Delete |
| OLE_EMBPASTE | Paste and Update |
| OLE_LNKPASTE | PasteLink (autoreconnect) |
| OLE_LOADFROMSTREAM | LoadFromStream (autoreconnect) |
| OLE_NONE | No operation active |
| OLE_OTHER | Other miscellaneous asynchronous operations |
| OLE_RECONNECT | Reconnect |
| OLE_REQUESTDATA | OleRequestData |
| OLE_RUN | Run |
| OLE_SERVERUNLAUNCH | Server is stopping |
| OLE_SETDATA | OleSetData |
| OLE_SETUPDATEOPTIONS | Setting update options |
| OLE_SHOW | Show |
| OLE_UPDATE | Update |
If the pointer passed in the lpobj parameter is invalid, the function returns OLE_ERROR_OBJECT.
A client application receives the OLE_RELEASE notification when an asynchronous operation has ended. The client can then call OleQueryReleaseMethod to check which operation caused the library to send the OLE_RELEASE notification. The client calls OleQueryReleaseError to determine whether the operation terminated successfully or with an error value.