Compartilhar via


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

Confira também

IStream – Implementação de arquivo composto

STATFLAG

STATSTG