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, no Windows Vista, no Windows Server 2008 e em 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 [ fora]

Aponta para uma estrutura STATSTRUCT em que esse método coloca informações sobre este objeto de fluxo. Esse ponteiro será nulo se ocorrer um erro.

grfStatFlag [ no]

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

Retornar valor

O valor de retorno é 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
[Somente aplicativos da área de trabalho do Windows XP]
Servidor mínimo com suporte
[Somente aplicativos da área de trabalho do Windows Server 2003]
Fim do suporte do cliente
Windows XP
Fim do suporte do servidor
Windows Server 2003
parâmetro
Scardssp. h
Biblioteca de tipos
Scardssp. tlb
DLL
Scardssp.dll
IID
IID _ IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9