nf-oledlg-ioleuilinkcontainerw-setlinksource.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:oledlg.IOleUILinkContainerW.SetLinkSource	IOleUILinkContainerW::SetLinkSource (oledlg.h)	Changes the source of a link. (Unicode)	IOleUILinkContainer interface [COM] SetLinkSource method IOleUILinkContainer::SetLinkSource IOleUILinkContainerA interface [COM] SetLinkSource method IOleUILinkContainerA::SetLinkSource IOleUILinkContainerW interface [COM] SetLinkSource method IOleUILinkContainerW.SetLinkSource IOleUILinkContainerW::SetLinkSource SetLinkSource SetLinkSource method [COM] SetLinkSource method [COM] IOleUILinkContainer interface SetLinkSource method [COM] IOleUILinkContainerA interface SetLinkSource method [COM] IOleUILinkContainerW interface com.ioleuilinkcontainer_setlinksource ole_IOleUILinkContainer_SetLinkSource oledlg/IOleUILinkContainer::SetLinkSource oledlg/IOleUILinkContainerA::SetLinkSource oledlg/IOleUILinkContainerW::SetLinkSource	com\ioleuilinkcontainer_setlinksource.htm	com	c76723e8-e895-4ba1-9ba1-7e56a44cc5f2	12/05/2018	IOleUILinkContainer interface [COM],SetLinkSource method, IOleUILinkContainer::SetLinkSource, IOleUILinkContainerA interface [COM],SetLinkSource method, IOleUILinkContainerA::SetLinkSource, IOleUILinkContainerW interface [COM],SetLinkSource method, IOleUILinkContainerW.SetLinkSource, IOleUILinkContainerW::SetLinkSource, SetLinkSource, SetLinkSource method [COM], SetLinkSource method [COM],IOleUILinkContainer interface, SetLinkSource method [COM],IOleUILinkContainerA interface, SetLinkSource method [COM],IOleUILinkContainerW interface, com.ioleuilinkcontainer_setlinksource, ole_IOleUILinkContainer_SetLinkSource, oledlg/IOleUILinkContainer::SetLinkSource, oledlg/IOleUILinkContainerA::SetLinkSource, oledlg/IOleUILinkContainerW::SetLinkSource	oledlg.h		Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]													Windows			19H1	IOleUILinkContainerW::SetLinkSource oledlg/IOleUILinkContainerW::SetLinkSource	c++	APIRef kbSyntax	COM	OleDlg.h	IOleUILinkContainer.SetLinkSource IOleUILinkContainerA.SetLinkSource IOleUILinkContainerW.SetLinkSource

IOleUILinkContainerW::SetLinkSource

-description

Changes the source of a link.

-parameters

-param dwLink [in]

Container-defined unique identifier for a single link. See IOleUILinkContainer::GetNextLink.

-param lpszDisplayName [in]

Pointer to new source string to be parsed.

-param lenFileName [in]

Length of the leading file name portion of the lpszDisplayName string. If the link source is not stored in a file, then lenFileName should be 0. For OLE links, call IOleLink::GetSourceDisplayName.

-param pchEaten [out]

Pointer to the number of characters successfully parsed in lpszDisplayName.

-param fValidateSource [in]

TRUE if the moniker should be validated; for OLE links, MkParseDisplayName should be called. FALSE if the moniker should not be validated. If possible, the link should accept the unvalidated source, and mark itself as unavailable.

-returns

This method returns S_OK on success. Other possible return values include the following.

Return code	Description
E_ACCESSDENIED	Insufficient access permissions.
E_FAIL	The operation failed.
E_INVALIDARG	The supplied identifier is invalid.
E_OUTOFMEMORY	Insufficient memory available for this operation.

-remarks

Notes to Callers

Call this method from the Change Source dialog box, with fValidateSource initially set to TRUE. Change Source can be called directly or from the Links dialog box. If this call to IOleUILinkContainer::SetLinkSource returns an error (e.g., MkParseDisplayName failed because the source was unavailable), then you should display an Invalid Link Source message, and the user should be allowed to decide whether to fix the source. If the user chooses to fix the source, then the user should be returned to the Change Source dialog box with the invalid portion of the input string highlighted. If the user chooses not to fix the source, then IOleUILinkContainer::SetLinkSource should be called a second time with fValidateSource set to FALSE, and the user should be returned to the Links dialog box with the link marked Unavailable.

-see-also

IOleUILinkContainer

MkParseDisplayName