IHlinkSite::ReadyToNavigate

Notifies the hyperlink site that the hyperlink navigation is about to occur. To back out of the operation, return E_ABORT.

HRESULT ReadyToNavigate(
  DWORD dwSiteData, //Site data for the hyperlink object
  DWORD dwReserved  //Reserved for future use
);
 

Parameters

dwSiteData

[in] Identifies 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.

Return Values

S_OK

The hyperlink site has been successfully notified.

QuickInfo

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

See Also

HlinkOnNavigate, IHlinkBrowseContext::OnNavigateHlink, IHlinkFrame::OnNavigate