Contents Index Topic Contents
	Previous Topic: IHlinkTarget::GetFriendlyName Next Topic: IHlinkTarget::Navigate

IHlinkTarget::GetMoniker

HRESULT GetMoniker(
    LPCWSTR pwzLocation,     //Hyperlink destination within this target
    DWORD dwAssign,     //Whether or not to create a moniker if one not found
    IMoniker * ppimkLocation    //Buffer to receive this moniker
   );

Returns a moniker to the hyperlink target object for the given hyperlink destination szLocation.

• Returns one of the following

  S_OK	The moniker to the hyperlink target object was retrieved.
  E_FAIL	A moniker does not exist for this hyperlink target, and OLEGETMONIKER_ONLYIFTHERE was specified for dwAssign.
  CreateFileMoniker, MkParseDisplayName, and other moniker creation API errors

pwzLocation

[in, unique] Used to identify the hyperlink destination within this target.

dwAssign

[in] A value from the OLEGETMONIKER enumeration. This is typically either OLEGETMONIKER_ONLYIFTHERE, indicating the function should not force a moniker to be created if one does not already exist, or OLEGETMONIKER_FORCEASSIGN, indicating that the function should create a moniker if one does not exist.

ppimkLocation

[out] Address of location to return the IMoniker interface pointer to the hyperlink target object for this szLocation.

See also HlinkSimpleNavigateToMoniker, IHlink::GetMonikerReference, IHlinkSite::GetMoniker

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.