IHlinkBrowseContext::QueryHlink

Tests the validity of a uHLID value.

HRESULT QueryHlink(
  DWORD grfHLQF,  //Value from the HLQF enumeration
  ULONG uHLID     //Hyperlink identifier to query
);
 

Parameters

grfHLQF

[in] A single value taken from the HLQF enumeration.

uHLID

[in] Identifies the hyperlink to query about. May be a value taken from the HLID constants to indicate a logically identified hyperlink, such as HLID_PREVIOUS or HLID_NEXT.

Return Values

S_OK

If grfHLQF is HLQF_ISVALID, uHLID identifies a valid hyperlink within the browse context. If grfHLQF is HLQF_ISCURRENT, uHLID identifies the current hyperlink of the browse context.

S_FALSE

If grfHLQF is HLQF_ISVALID, uHLID does not identify a valid hyperlink within the browse context. If grfHLQF is HLQF_ISCURRENT, uHLID does not identify the current hyperlink of the browse context.

QuickInfo

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

See Also

HLID, HLQF