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

Artigo
03/13/2024

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