Contents Index Topic Contents
	Previous Topic: HlinkNavigateMoniker Next Topic: HlinkNavigateToStringReference

HlinkNavigateString

HRESULT HlinkNavigateString(
    IUnknown * pUnk,    //IUnknown pointer to the initiating document or object
    LPCWSTR szTarget    //Moniker of the hyperlink target
   );

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

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

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.

szTarget

[in] String that helps identify the hyperlink target. This string is resolved into a moniker for underlying binding operations through MkParseDisplayNameEx. If NULL, the navigation is within a document.

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

The HlinkNavigateString 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, HlinkNavigateMoniker, HlinkNavigateToStringReference, HlinkSimpleNavigateToString, IHlink::Navigate

---

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