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]
-
Zeigt 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 der 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.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ IByteBuffer ist als E126F8FE-A7AF-11D0-B88A-00C04FD424B9 definiert. |