HlinkGoForward

This function executes a hyperlink jump forwards within the navigation stack.

HRESULT HlinkGoForward(
  IUnknown *pUnk  //IUnknown pointer to the initiating document or 
                  // object
);
 

Parameters

pUnk
[in] Pointer to the IUnknown interface on the document or object that is initiating the hyperlink. Must not be NULL.

Return Values

S_OK
The hyperlink jump has executed successfully.

Remarks

The HlinkGoForward helper function should be used by all applications, documents, and objects that have simple navigational 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.

The specified pointer pUnk must point to an object that is hosted within a hyperlink-aware container, such as Microsoft Internet Explorer or an ActiveX hyperlink frame.

Note that this function will only work if the object calling the function is the current object in the navigation stack. In HTML pages with frame-sets, HlinkGoForward only affects the current frame.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in hlink.h.

See Also

HlinkGoBack