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

ILockBytes – Implementação de memória global

STATFLAG

STATSTG