INameSpaceTreeControl：：GetItemState 方法 (shobjidl_core.h)

获取有关 Shell 项的状态信息。

语法

HRESULT GetItemState(
  [in]  IShellItem    *psi,
  [in]  NSTCITEMSTATE nstcisMask,
  [out] NSTCITEMSTATE *pnstcisFlags
);

参数

[in] psi

类型： IShellItem*

指向要从中检索状态的 Shell 项的指针。

[in] nstcisMask

类型： NSTCITEMSTATE

以位图的形式指定要请求的信息。 一个或多个 NSTCITEMSTATE 常量。

[out] pnstcisFlags

类型： NSTCITEMSTATE*

此方法返回时，指向包含 nstcisMask 中请求的值的位图。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

nstcisMask 值指定请求 pnstcisFlags 指向的值中的哪些位。 例如，如果 nstcisMask=NSTCIS_SELECTED，则此方法返回时，只有 pnstcisFlags 指向的值中的第一个位有效。 如果 pnstcisFlags 指向的值中的第一个位为 1，则设置NSTCIS_SELECTED标志。 如果 pnstcisFlags 指向的值中的第一个位为 0，则不设置NSTCIS_SELECTED标志。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)