Contents Index Topic Contents
	Previous Topic: HlinkNavigate Next Topic: HlinkNavigateString

HlinkNavigateMoniker

HRESULT HlinkNavigateMoniker(
    IUnknown * pUnk,        //IUnknown pointer to the initiating document or object
    IMoniker * pmkTarget    //Moniker of the hyperlink target
   );

Executes a hyperlink jump to a new document or object (specified in pmkTarget).

• Returns S_OK if a hyperlink jump to a new document or object has executed successfully.

  This function can also return any value returned by IHlink::Navigate.

pUnk

[in] Address of the IUnknown interface on the document or object that is initiating the hyperlink. If NULL, it is assumed the hyperlink originates from an ActiveX-unaware application.

pmkTarget

[in] Address of the moniker that identifies the hyperlink target. If NULL, the navigation is within a document.

HlinkNavigateMoniker is implemented as a simple macro that calls the HlinkSimpleNavigateToMoniker function, passing it NULL for most parameters.

The HlinkNavigateMoniker helper function should be used by all applications, documents, and objects that have simple navigation needs. This single function call will "do the right thing" depending on whether the navigation is originating from within a hyperlink frame or within a hyperlink-unaware application.

See also HLNF, HlinkNavigateString, HlinkNavigateToStringReference, HlinkSimpleNavigateToMoniker, IHlink::Navigate

---

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