GetLogFileInformation-Funktion (clfsw32.h)
Gibt einen Puffer zurück, der Metadaten zu einem angegebenen Protokoll und dessen aktuellem Zustand enthält, der durch die CLFS_INFORMATION-Struktur definiert wird.
Die abgerufenen Daten geben den Zustand des Protokolls nur zum Zeitpunkt des Aufrufs wieder. In der Regel kann ein Client weiterhin Felder aus dieser Struktur zwischenspeichern und verwenden, bis er das nächste Mal Datensätze anfügen oder seinen Neustartbereich schreibt. Zu diesem Zeitpunkt ist ein Teil der Informationen veraltet.
Syntax
CLFSUSER_API BOOL GetLogFileInformation(
[in] HANDLE hLog,
[in, out] PCLFS_INFORMATION pinfoBuffer,
[in, out] PULONG cbBuffer
);
Parameter
[in] hLog
Ein Handle für ein geöffnetes Protokoll, das aus einem erfolgreichen Aufruf von CreateLogFile abgerufen wird.
Das Protokollhandle kann auf ein dediziertes oder multiplexiertes Protokoll verweisen.
[in, out] pinfoBuffer
Ein Zeiger auf eine vom Benutzer zugewiesene CLFS_INFORMATION Struktur, die die Protokollmetadaten empfängt.
[in, out] cbBuffer
Ein Zeiger auf eine Variable, die bei der Eingabe die Größe des Metadatenpuffers in Bytes angibt, auf den pinfoBuffer verweist.
Bei der Ausgabe gibt es die Anzahl der Bytes an, die tatsächlich in pinfoBuffer kopiert werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Die folgende Liste identifiziert die möglichen Fehlercodes:
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 |