IStorage::Stat

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

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

Syntax

HRESULT Stat( 
  STATSTG* pstatstg, 
  DWORD grfStatFlag 
);

Parameters

pstatstg
[out] Em retorno, ponteiro para um STATSTG estrutura onde este método coloca informações sobre o aberto objeto armazenamento.

Este parâmetro é NULL se ocorrer um erro.

grfStatFlag
[no] Valor que especifica que alguns dos membros na STATSTG estrutura não são retornados. Isso salva uma operação alocação memória.

Os valores são tirados do STATFLAG enumeração.

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 todo dados do armazenamento está não disponível. Para obter mais informações consulte o IFillLockBytes interface e o armazenamento assíncrono.
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_INVALIDPARAMETER	Um dos parâmetros era inválido.

Remarks

IStorage::STAT Recupera o STATSTG estrutura para o atual armazenamento. Essa estrutura contém informações estatísticas sobre o armazenamento.

O IStorage::EnumElements método cria um objeto enumerador com o IEnumSTATSTG interface, embora o qual você pode enumerar a substorages e fluxos de um armazenamento através de STATSTG estrutura de cada.

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

Compartilhar via