HlinkNavigateMoniker Function

---

Executes a hyperlink jump, specified by a moniker, to a new document or object. For information about how this function relates to the HlinkSimpleNavigateToMoniker function, see the Remarks section.

Syntax

HRESULT HlinkNavigateMoniker(
    IUnknown *pUnk,        
    IMoniker *pmkTarget    
);

Parameters

pUnk

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

pmkTarget

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

Return Value

Returns S_OK if successful. This function can also return any value returned by IHlink::Navigate.

Remarks

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. The simple hyperlink navigation model enables a user to jump from one page to another, but does not provide support for more complex operations, such as cutting and pasting hyperlinks. This function performs navigation if it originates from within a hyperlink frame.

Function Information

Windows NT	Use version 4.0
Windows	Use Windows 95 and later
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0

See Also

HLNF, HlinkNavigateString, HlinkNavigateToStringReference