GetLogIoStatistics-Funktion (clfsw32.h)
Ruft Protokoll-E/A-Statistiken für ein dediziertes oder multiplextes Protokoll ab, das dem angegebenen Handle zugeordnet ist. Diese Funktion fragt das Common Log File System (CLFS) nach bestimmten Typen von Protokoll-E/A-Statistiken ab. Beim Aufrufen dieser Funktion in einem Multiplexprotokoll werden die Statistiken nur dem zugrunde liegenden Protokoll zugeordnet.
Syntax
CLFSUSER_API BOOL GetLogIoStatistics(
[in] HANDLE hLog,
[in, out] PVOID pvStatsBuffer,
[in] ULONG cbStatsBuffer,
[in] CLFS_IOSTATS_CLASS eStatsClass,
[out, optional] PULONG pcbStatsWritten
);
Parameter
[in] hLog
Ein Handle für eine geöffnete Protokolldatei, die CreateLogFile abruft. Das Protokollhandle kann auf eine dedizierte oder multiplexte Protokolldatei verweisen.
[in, out] pvStatsBuffer
Ein Zeiger auf einen Puffer zum Empfangen der E/A-Statistiken.
Dieser Puffer muss mindestens so groß sein wie ein E/A-Statistikpaketheader. Weitere Informationen finden Sie unter CLFS_IO_STATISTICS_HEADER.
[in] cbStatsBuffer
Die Größe des E/A-Statistikpuffers pvStatsBuffer in Bytes.
Wenn der Puffer nicht groß genug für das Statistikpaket ist, schlägt die Funktion mit ERROR_MORE_DATA fehl.
[in] eStatsClass
Dieser Parameter ist derzeit nicht implementiert. sie ist für die zukünftige Verwendung reserviert.
[out, optional] pcbStatsWritten
Ein Zeiger auf eine Variable zum Empfangen der Größe des E/A-Statistikpakets, das in pvStatsBuffer geschrieben wird.
Dieser Wert ist kleiner oder gleich cbStatsBuffer.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. In der folgenden Liste werden die möglichen Fehlercodes identifiziert:
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | clfsw32.h |
| Bibliothek | Clfsw32.lib |
| DLL | Clfsw32.dll |