Método IStorage::Stat (objidl.h)
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 |