INameSpaceTreeControl::SetItemState-Methode (shobjidl_core.h)

  • Artikel

Legt Zustandsinformationen für ein Shellelement fest.

Syntax

HRESULT SetItemState(
  [in] IShellItem    *psi,
  [in] NSTCITEMSTATE nstcisMask,
  [in] NSTCITEMSTATE nstcisFlags
);

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf das Shellelement, für das der Zustand festgelegt werden soll.

[in] nstcisMask

Typ: NSTCITEMSTATE

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

[in] nstcisFlags

Typ: NSTCITEMSTATE

Eine Bitmap, die die Werte enthält, die für die in nstcisMask angegebenen Flags festgelegt werden sollen.

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 festgelegt werden sollen, auf den pnstcisFlags verweist. Andere Bits werden ignoriert. Ein einfaches Beispiel: Wenn nstcisMask=NSTCIS_SELECTED, bestimmt das erste Bit im nstcisFlags-Wert , ob dieses Flag festgelegt (1) oder entfernt wird (0).

Anforderungen

Anforderung Wert
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 (shobjidl.h einschließen)