INameSpaceTreeControl::GetItemState-Methode (shobjidl_core.h)

Ruft Zustandsinformationen zu einem Shellelement ab.

Syntax

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

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf das Shellelement, aus dem der Zustand abgerufen werden soll.

[in] nstcisMask

Typ: NSTCITEMSTATE

Gibt an, welche Informationen in Form einer Bitmap angefordert werden. Mindestens eine der NSTCITEMSTATE-Konstanten .

[out] pnstcisFlags

Typ: NSTCITEMSTATE*

Wenn diese Methode zurückgibt, zeigt auf eine Bitmap, die die in nstcisMask angeforderten Werte enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der nstcisMask-Wert gibt an, welche Bits im Wert angefordert werden, auf den pnstcisFlags verweist. Ein einfaches Beispiel: Wenn nstcisMask=NSTCIS_SELECTED, ist nur das erste Bit im Wert gültig, auf den pnstcisFlags verweist, wenn diese Methode zurückgibt. Wenn das erste Bit im Wert, auf den pnstcisFlags verweist, 1 ist, wird das flag NSTCIS_SELECTED festgelegt. Wenn das erste Bit im Wert, auf den pnstcisFlags verweist, 0 ist, wird das flag NSTCIS_SELECTED nicht festgelegt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)