Contents Index Topic Contents
	Previous Topic: HlinkGoBack Next Topic: HlinkNavigate

HlinkGoForward

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

Executes a hyperlink jump forward within the navigation stack.

• Returns S_OK if the hyperlink jump has executed successfully.

pUnk

[in] Address of the IUnknown interface on the document or object that is initiating the hyperlink. Must not be NULL.

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 work only 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.

See also HlinkGoBack

---

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