IStream::Stat

9/8/2008

Este método recupera o STATSTG estrutura para este objeto transmitir.

Syntax

HRESULT Stat( 
  STATSTG* pstatstg, 
  DWORD grfStatFlag 
);

Parameters

• pstatstg
  [out] Ponteiro para um STATSTG estrutura onde este método coloca informações sobre esse objeto transmitir. Esse ponteiro é NULL se ocorrer um erro.

• grfStatFlag
  [no] Valor que especifica que este método não retorna alguns dos membros na STATSTG estrutura. Isso salva uma operação alocação memória.

  Os valores são tirados da enumeração de STATFLAG.

Return Value

A seguinte tabela mostra os valores de retorno para este método.

Valor	Descrição
S_OK	O STATSTG estrutura foi retornada com êxito na localidade especificada.
E_PENDING	Somente armazenamento assíncrono: Parte ou todos os dados de transmitir é atualmente não disponível.
STG_E_ACCESSDENIED	O chamador não tem permissões suficientes para acessar as estatísticas para este objeto armazenamento.
STG_E_INSUFFICIENTMEMORY	O STATSTG estrutura não retornou devido a uma falta de memória.
STG_E_INVALIDFLAG	O valor para o grfStateFlag parâmetro não é válido.
STG_E_INVALIDPOINTER	O pStatStg ponteiro não é válido.
STG_E_REVERTED	O objeto tenha sido invalidado por uma operação de reversão acima na árvore de transação.

Remarks

IStream::STAT Recupera um ponteiro para o STATSTG estrutura que contém informações sobre este aberto transmitir.

Quando esse transmitir está dentro um armazenamento estruturado e o IStorage::EnumElements método for chamado, ele cria um objeto enumerador com o IEnumSTATSTG interface nele. Isso pode ser chamado para enumerar os armazenamentos e fluxos através de STATSTG Estruturas associado com cada uma das-los.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later