Metodo INameSpaceTreeControl::GetItemState (shobjidl_core.h)

Ottiene informazioni sullo stato su un elemento shell.

Sintassi

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

Parametri

[in] psi

Tipo: IShellItem*

Puntatore all'elemento shell da cui recuperare lo stato.

[in] nstcisMask

Tipo: NSTCITEMSTATE

Specifica quali informazioni vengono richieste, sotto forma di bitmap. Una o più costanti NSTCITEMSTATE .

[out] pnstcisFlags

Tipo: NSTCITEMSTATE*

Quando questo metodo restituisce, punta a una bitmap contenente i valori richiesti in nstcisMask.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il valore nstcisMask specifica quali bit nel valore puntato da pnstcisFlags vengono richiesti. Come esempio semplice, se nstcisMask=NSTCIS_SELECTED, solo il primo bit del valore a cui punta da pnstcisFlags è valido quando questo metodo restituisce. Se il primo bit del valore puntato da pnstcisFlags è 1, viene impostato il flag di NSTCIS_SELECTED. Se il primo bit del valore puntato da pnstcisFlags è 0, il flag di NSTCIS_SELECTED non è impostato.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)