Método ILockBytes::Stat (objidl.h)
O método Stat recupera uma estrutura STATSTG que contém informações para esse objeto de matriz de bytes.
Sintaxe
HRESULT Stat(
[out] STATSTG *pstatstg,
[in] DWORD grfStatFlag
);
Parâmetros
[out] pstatstg
Ponteiro para uma estrutura STATSTG na qual esse método coloca informações sobre esse objeto de matriz de bytes. O ponteiro será NULL se ocorrer um erro.
[in] grfStatFlag
Especifica se esse método deve fornecer o membro pwcsName da estrutura STATSTG por meio de valores obtidos da enumeração STATFLAG . Se o STATFLAG_NONAME for especificado, o membro pwcsName de STATSTG não será fornecido, salvando assim uma operação de alocação de memória. O outro valor possível, STATFLAG_DEFAULT, indica que todos os membros da estrutura STATSTG serão fornecidos.
Valor retornado
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_OUTOFMEMORY | A estrutura STATSTG não foi retornada devido à falta de memória para o membro de nome na estrutura. |
STG_E_ACCESSDENIED | A estrutura STATSTG não foi retornada porque o chamador não tinha acesso à matriz de bytes. |
STG_E_INSUFFICIENTMEMORY | A estrutura STATSTG não foi retornada devido à memória insuficiente. |
STG_E_INVALIDFLAG | O valor do parâmetro grfStateFlag não é válido. |
STG_E_INVALIDPOINTER | O valor do parâmetro pStatStg não é válido. |
Comentários
ILockBytes::Stat deve fornecer informações sobre o objeto de matriz de bytes em uma estrutura STATSTG .
Requisitos
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
ILockBytes – implementação de File-Based