IHlinkSite::OnNavigationComplete


		Contents Index Topic Contents
	Previous Topic: IHlinkSite::GetMoniker Next Topic: IHlinkSite::QueryService

IHlinkSite::OnNavigationComplete
HRESULT OnNavigationComplete(
    DWORD dwSiteData,    //Site data for the hyperlink object
    DWORD dwReserved,    //Reserved for future use
    HRESULT hrError,     //Result of the hyperlink navigation
    LPCWSTR pwzError     //Description of the failure, if any
   );
Notifies the hyperlink site that a hyperlink navigation has been successful.
Returns S_OK if the hyperlink site has been successfully notified.

dwSiteData
[in] Used to identify the hyperlink to the hyperlink site. The hyperlink site initializes the hyperlink with this value as part of IHlink::SetHlinkSite.
dwReserved
[in] Reserved for future use; must be set to zero by the caller. To ensure compatibility with future use, the callee must not check for zero.
hrError
[in] Result of the hyperlink navigation. Either S_OK for success, or E_ABORT or E_FAIL for failure.
pwzError
[in] Address of the string describing the failure that occurred.

This notification is particularly useful if the hyperlink has been navigated asynchronously, because it is the only notification the hyperlink receives to realize that hyperlinking has completed.
See also HlinkOnNavigate, IHlinkBrowseContext::OnNavigateHlink, IHlinkFrame::OnNavigate

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