INameSpaceTreeControl::GetItemState メソッド (shobjidl_core.h)

シェル項目に関する状態情報を取得します。

構文

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

パラメーター

[in] psi

種類: IShellItem*

状態を取得するシェル項目へのポインター。

[in] nstcisMask

型: NSTCITEMSTATE

ビットマップの形式で、要求する情報を指定します。 1 つ以上の 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 を含む)