IHlinkFrame::Navigate Method

Navigates to the target hyperlink.

Syntax

Copy

HRESULT Navigate(
    DWORD grfHLNF,
    LPBC pbc,
    IBindStatusCallback *pibsc,
    IHlink *pihlNavigate
);

Parameters

grfHLNF

[in] An unsigned long integer value that specifies the flag that describes how the navigation is to proceed. The value of the flag can be any valid HLNF enumeration value.

pbc

[in] The address of the bind context interface to use for any moniker binding during this operation. This cannot be NULL.

pibsc

[in] The address of the IBindStatusCallback object interface to use for any asynchronous moniker binding that is performed during the navigation. If this is NULL, the caller does not receive progress notification, cancellation, pausing, or low-level binding information.

pihlNavigate

[in] The address of the IHlink object interface to the hyperlink target.

Return Value

Returns S_OK if successful, or one of the IHlink::Navigate errors otherwise.

Remarks

The MSHTML document calls this method on the host frame when a link is clicked. This is the frame's chance to provide an integrated user interface, cancel the navigation, and so forth. Often the frame simply sets some flags and defers to the IHlink::Navigate method.

See Also

Hyperlinks Overview