Método IByteBuffer::Stat
[O método Stat está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A interface IStream fornece funcionalidade semelhante.]
O método Stat recupera informações estatísticas do objeto stream.
Sintaxe
HRESULT Stat(
[out] LPSTATSTRUCT pstatstg,
[in] LONG grfStatFlag
);
Parâmetros
-
pstatstg [out]
-
Aponta para uma estrutura STATSTRUCT em que esse método coloca informações sobre esse objeto de fluxo. Esse ponteiro será NULL se ocorrer um erro.
-
grfStatFlag [in]
-
Especifica que esse método não retorna alguns dos campos na estrutura STATSTRUCT , salvando assim uma operação de alocação de memória. Os valores são obtidos da enumeração STATFLAG
Valor retornado
O valor retornado é um HRESULT. Um valor de S_OK indica que a chamada foi bem-sucedida.
Comentários
O método IByteBuffer::Stat recupera um ponteiro para a estrutura STATSTRUCT que contém informações sobre esse fluxo aberto.
Exemplos
O exemplo a seguir mostra a recuperação de informações estatísticas do fluxo.
STATSTRUCT statstr;
HRESULT hr;
// Retrieve the statistical information.
hr = pIByteBuff->Stat(&statstr,
STATFLAG_DEFAULT);
if (FAILED(hr))
printf("Failed IByteBuffer::Stat\n");
else
// Use statstr as needed.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Fim do suporte ao cliente |
Windows XP |
| Fim do suporte ao servidor |
Windows Server 2003 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| IID |
IID_IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |