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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP
Ende des Supports (Server)	Windows Server 2003
Header	Scardssp.h
Typbibliothek	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer ist definiert als E126F8FE-A7AF-11D0-B88A-00C04FD424B9