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