Méthode INameSpaceTreeControl::GetItemState (shobjidl_core.h)

Obtient des informations d’état sur un élément Shell.

Syntaxe

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

Paramètres

[in] psi

Type : IShellItem*

Pointeur vers l’élément Shell à partir duquel récupérer l’état.

[in] nstcisMask

Type : NSTCITEMSTATE

Spécifie les informations demandées, sous la forme d’une bitmap. Une ou plusieurs constantes NSTCITEMSTATE .

[out] pnstcisFlags

Type : NSTCITEMSTATE*

Lorsque cette méthode retourne, pointe vers une bitmap qui contient les valeurs demandées dans nstcisMask.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La valeur nstcisMask spécifie les bits de la valeur pointée par pnstcisFlags qui sont demandés . Par exemple, si nstcisMask=NSTCIS_SELECTED, seul le premier bit de la valeur pointée par pnstcisFlags est valide lorsque cette méthode retourne. Si le premier bit de la valeur pointée par pnstcisFlags est 1, l’indicateur NSTCIS_SELECTED est défini. Si le premier bit de la valeur pointée par pnstcisFlags est 0, l’indicateur NSTCIS_SELECTED n’est pas défini.

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)