OleSetLinkUpdateOptions

3.1

  #include <ole.h>    

  OLESTATUS OleSetLinkUpdateOptions(lpObject, UpdateOpt)    
  LPOLEOBJECT lpObject; /* address of object */
  OLEOPT_UPDATE UpdateOpt; /* link-update options */

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

Parameters

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_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.

Return Value

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_BUSY
OLE_ERROR_OBJECT
OLE_ERROR_OPTION
OLE_ERROR_STATIC
OLE_WAIT_FOR_RELEASE

See Also

OleGetLinkUpdateOptions