IOleUILinkContainer::SetLinkUpdateOptions

Sets a link's update options to Automatic (OLEUPDATE_ALWAYS) or Manual (OLEUPDATE_ONCALL).

HRESULT SetLinkUpdate(
  DWORD dwLink,      //Unique 32-bit link identifier
  DWORD dwUpdateOpt  //Update options
);

Parameters

dwLink: [in] Container-defined unique 32-bit identifier for a single link. See IOleUILinkContainer::GetNextLink.
dwUpdateOpt: [in] Update options, which can be Automatic (OLEUPDATE_ALWAYS) or Manual (OLEUPDATE_ONCALL).

Return Values

This method supports the standard return values E_FAIL,

E_INVALIDARG, and E_OUTOFMEMORY, as well as the following:

S_OK: Successfully set the links update options.
E_ACCESSDENIED: Insufficient access permissions.

Remarks

The user selects update options from the Links dialog box.

Notes To Implementers

Containers can implement this method for OLE links by simply calling IOleLink::SetUpdateOptions on the link object.

QuickInfo