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

Obtém informações de estado sobre um item do Shell.

Sintaxe

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

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para o item shell do qual recuperar o estado.

[in] nstcisMask

Tipo: NSTCITEMSTATE

Especifica quais informações estão sendo solicitadas, na forma de um bitmap. Uma ou mais das constantes NSTCITEMSTATE .

[out] pnstcisFlags

Tipo: NSTCITEMSTATE*

Quando esse método retorna, aponta para um bitmap que contém os valores solicitados em nstcisMask.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O valor nstcisMask especifica quais bits no valor apontado por pnstcisFlags são solicitados . Como um exemplo simples, se nstcisMask=NSTCIS_SELECTED, somente o primeiro bit no valor apontado por pnstcisFlags será válido quando esse método retornar. Se o primeiro bit no valor apontado por pnstcisFlags for 1, o sinalizador NSTCIS_SELECTED será definido. Se o primeiro bit no valor apontado por pnstcisFlags for 0, o sinalizador NSTCIS_SELECTED não será definido.

Requisitos