Compartilhar via


Método IStorage::Stat (objidl.h)

O método Stat recupera a estrutura STATSTG para esse objeto de armazenamento aberto.

Sintaxe

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

Parâmetros

[out] pstatstg

No retorno, o ponteiro para uma estrutura STATSTG em que esse método coloca informações sobre o objeto de armazenamento aberto. Esse parâmetro será NULL se ocorrer um erro.

[in] grfStatFlag

Especifica que alguns dos membros na estrutura STATSTG não são retornados, salvando assim uma operação de alocação de memória. Os valores são obtidos da enumeração STATFLAG .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK A estrutura STATSTG foi retornada com êxito no local especificado.
E_PENDING Somente armazenamento assíncrono: parte ou todos os dados do armazenamento estão indisponíveis no momento.
STG_E_ACCESSDENIED O chamador não tem permissões suficientes para acessar estatísticas para esse objeto de armazenamento.
STG_E_INSUFFICIENTMEMORY A estrutura STATSTG não foi retornada devido à falta de memória.
STG_E_INVALIDFLAG O valor do parâmetro grfStateFlag não é válido.
STG_E_INVALIDPARAMETER Um dos parâmetros não era válido.

Comentários

IStorage::Stat recupera a estrutura STATSTG para o objeto de armazenamento atual. A estrutura STATSTG contém informações estatísticas sobre o objeto de armazenamento. IStorage::EnumElements retorna um ponteiro para um objeto enumerador. O objeto enumerador retornado por esse método implementa a interface IEnumSTATSTG , por meio da qual os dados armazenados na matriz das estruturas STATSTG são enumerados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

Ienumstatstg

IStorage – Implementação de arquivo composto

IStorage::SetClass

IStorage::SetElementTimes

IStorage::SetStateBits

STATFLAG

STATSTG