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

See Also

IOleUILinkContainer::GetNextLink, IOleUILinkContainer::GetLinkUpdateOptions, IOleLink::SetUpdateOptions