Método IByteBuffer::Stat

[El método Stat está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La interfaz IStream proporciona una funcionalidad similar.]

El método Stat recupera información estadística del objeto stream.

Sintaxis

HRESULT Stat(
  [out] LPSTATSTRUCT pstatstg,
  [in]  LONG         grfStatFlag
);

Parámetros

pstatstg [out]

Apunta a una estructura STATSTRUCT donde este método coloca información sobre este objeto de secuencia. Este puntero es NULL si se produce un error.

grfStatFlag [in]

Especifica que este método no devuelve algunos de los campos de la estructura STATSTRUCT , lo que guarda una operación de asignación de memoria. Los valores se toman de la enumeración STATFLAG .

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que la llamada se realizó correctamente.

Comentarios

El método IByteBuffer::Stat recupera un puntero a la estructura STATSTRUCT que contiene información sobre esta secuencia abierta.

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar información estadística de la secuencia.

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