HlinkNavigateStringHlinkNavigateString*
*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).

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


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