9.7.4 OleSetLinkUpdateOptions

OLESTATUS OleSetLinkUpdateOptions(lpObject, UpdateOpt)

LPOLEOBJECT lpObject;

OLEOPT_UPDATE UpdateOpt;

The OleSetLinkUpdateOptions function sets the link-update options for the presentation of the specified object.

Parameter Description

lpObject Points to the object for which the link-update option is set.
UpdateOpt Specifies the link-update option for the specified object. This parameter can be one of the following values:

  Option Description
  oleupdate_always Update the linked object whenever possible. This option supports the Automatic link-update radio button in the Links dialog box.
  oleupdate_onsave Update the linked object when the source document is saved by the server.
  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.

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

OLE_BUSY

OLE_ERROR_OBJECT

OLE_ERROR_OPTION

OLE_ERROR_STATIC

OLE_WAIT_FOR_RELEASE

See AlsoOleGetLinkUpdateOptions