OleSetLinkUpdateOptions

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

The OleSetLinkUpdateOptions function sets the link-update options for 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_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.

Return Value

The return value is OLE_OK if the function is successful. Otherwise, it is an error value, which can be one of the following:

OLE_BUSY
OLE_ERROR_OBJECT
OLE_ERROR_OPTION
OLE_ERROR_STATIC
OLE_WAIT_FOR_RELEASE

See Also

OleGetLinkUpdateOptions