HlinkSimpleNavigateToMoniker function
[HlinkSimpleNavigateToMoniker may be altered or unavailable in subsequent versions of the operating system or product.]
Note The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.
Executes a hyperlink jump, specified by a moniker, to a new document or object.
Syntax
HRESULT HlinkSimpleNavigateToMoniker(
_In_ IMoniker *pmkTarget,
_In_ LPCWSTR szLocation,
_In_ LPCWSTR szTargetFrameName,
_In_ IUnknown *pUnk,
_In_ IBindCtx *pbc,
_In_ IBindStatusCallback *pbsc,
_In_ DWORD grfHLNF,
_Reserved_ DWORD dwReserved
);
Parameters
pmkTarget [in]
A pointer to the moniker that identifies the hyperlink target. If this is NULL, the navigation is within a document.szLocation [in]
Optional. A pointer to a string that specifies the location within the hyperlink target for the new hyperlink.szTargetFrameName [in]
Optional. A pointer to a string that specifies the name of the target frame for the hyperlink navigation. This argument only affects navigation in a document container that supports framesets.pUnk [in]
A pointer to 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. Note that if the caller of this function is an ActiveX control or document object, a valid value must be passed for this parameter for navigation to succeed.pbc [in]
A Pointer to the IBindCtx interface on the bind context to use for any moniker binding performed during the navigation. This must not be NULL.pbsc [in]
A pointer to the IBindStatusCallback interface on the bind-status-callback to use for any asynchronous moniker binding performed during the navigation. The bind-status-callback returns only the standard IUnknown methods: AddRef and QueryInterface. When navigating in a new window, the only IBindStatusCallback method that gets called is IBindStatusCallback::GetBindInfo. If this is NULL, the caller does not receive progress notification, cancellation, pausing, or low-level binding information.grfHLNF [in]
An unsigned long integer value that specifies one of the HLNF values.dwReserved [in]
Reserved. Must be set to NULL.
Return value
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This function is called by HlinkNavigateMoniker. The HlinkSimpleNavigateToMoniker helper function can be used by all applications, documents, and objects that have simple navigation requirements. The simple hyperlink navigation model enables a user to jump from one page to another page, 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.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows 2000 Server |
Header |
Urlmon.h |
Library |
Urlmon.lib |
DLL |
Urlmon.dll |
See also
Reference