IByteBuffer::Stat-Methode

[Die Stat-Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die IStream-Schnittstelle bietet ähnliche Funktionen.]

Die Stat-Methode ruft statistische Informationen aus dem Streamobjekt ab.

Syntax

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

Parameter

pstatstg [out]

Verweist auf eine STATSTRUCT-Struktur , in der diese Methode Informationen zu diesem Streamobjekt platziert. Dieser Zeiger ist NULL , wenn ein Fehler auftritt.

grfStatFlag [in]

Gibt an, dass diese Methode einige Felder in der STATSTRUCT-Struktur nicht zurückgibt, wodurch ein Speicherbelegungsvorgang gespeichert wird. Werte werden aus der STATFLAG-Enumeration übernommen.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass der Aufruf erfolgreich war.

Bemerkungen

Die IByteBuffer::Stat-Methode ruft einen Zeiger auf die STATSTRUCT-Struktur ab, die Informationen zu diesem geöffneten Stream enthält.

Beispiele

Das folgende Beispiel zeigt das Abrufen statistischer Informationen aus dem Stream.

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.

Anforderungen