INameSpaceTreeControl::HitTest method (shobjidl_core.h)

Retrieves the item that a given point is in, if any.

Syntax

HRESULT HitTest(
  [in]  POINT      *ppt,
  [out] IShellItem **ppsiOut
);

Parameters

[in] ppt

Type: POINT*

A pointer to the point to be tested.

[out] ppsiOut

Type: IShellItem**

The address of a pointer to the item in which the point exists, or NULL if the point does not exist in an item.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function returns S_FALSE with a NULL item if the point does not exist in an item.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)