| #include <ole.h> |
| OLESTATUS OleGetLinkUpdateOptions(lpObject, lpUpdateOpt) | |||||
| LPOLEOBJECT lpObject; | /* address of object to query | */ | |||
| OLEOPT_UPDATE FAR* lpUpdateOpt; | /* address of update options | */ | |||
The OleGetLinkUpdateOptions function retrieves the link-update options for the presentation of a specified object.
lpObject
Points to the object to query.
lpUpdateOpt
Points to a variable in which the function stores the current value of the link-update option for the specified object. The link-update option setting may be one of the following values:
| Value | Meaning |
| oleupdate_always | Update the linked object whenever possible. This option supports the Automatic link-update radio button in the Links dialog box. |
| oleupdate_oncall | Update the linked object only on request from the client application. This option supports the Manual link-update radio button in the Links dialog box. |
| oleupdate_onsave | Update the linked object when the source document is saved by the server. |
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_OBJECT OLE_ERROR_STATIC