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.