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

O método Stat recupera a estrutura STATSTG para esse fluxo.

Sintaxe

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

Parâmetros

[out] pstatstg

Ponteiro para uma estrutura STATSTG em que esse método coloca informações sobre esse objeto de fluxo.

[in] grfStatFlag

Especifica que esse método não retorna alguns dos membros na estrutura STATSTG , 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 fluxo 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_INVALIDPOINTER	O ponteiro pStatStg não é válido.
STG_E_REVERTED	O objeto foi invalidado por uma operação de reverter acima dele na árvore de transações.

Comentários

IStream::Stat recupera um ponteiro para a estrutura STATSTG que contém informações sobre esse fluxo aberto. Quando esse fluxo está dentro de um armazenamento estruturado e IStorage::EnumElements é chamado, ele cria um objeto enumerador com a interface IEnumSTATSTG nele, que pode ser chamado para enumerar os armazenamentos e fluxos por meio das estruturas STATSTG associadas a cada um deles.

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