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	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9