INameSpaceTreeControl：：GetItemState 方法 (shobjidl_core.h)

取得殼層專案的狀態資訊。

語法

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)