ValidateLog-Funktion (clfsw32.h)
Überprüft die Konsistenz der Protokollmetadaten und -daten vor dem Protokollarchiv und nach der Protokollwiederherstellung.
Syntax
CLFSUSER_API BOOL ValidateLog(
[in] LPCWSTR pszLogFileName,
[in, optional] LPSECURITY_ATTRIBUTES psaLogFile,
[out, optional] PCLFS_INFORMATION pinfoBuffer,
[in, out] PULONG pcbBuffer
);
Parameter
[in] pszLogFileName
Der Name des Protokolls.
Der Name wird beim Erstellen des Protokolls mithilfe CreateLogFile-angegeben. Im folgenden Beispiel wird das zu verwendende Format identifiziert:
Log:<LogName>[::<LogStreamName>]
< LogName> entspricht einem gültigen Dateipfad im Dateisystem.
< LogStreamName-> ist der eindeutige Name eines Protokolldatenstroms im dedizierten Protokoll.
Weitere Informationen finden Sie unter Protokolltypen.
[in, optional] psaLogFile
Ein Zeiger auf eine SECURITY_ATTRIBUTES Struktur, die die Sicherheitsattribute eines Protokolls angibt.
Dieser Parameter kann NULL-sein.
[out, optional] pinfoBuffer
Ein Zeiger auf eine CLFS_INFORMATION Struktur, die Protokollmetadaten empfängt.
[in, out] pcbBuffer
Ein Zeiger auf eine Variable, die bei eingabe die Größe des pinfoBuffer- Metadatenpuffers in Byte angibt.
Bei der Ausgabe empfängt sie die Menge an Informationen, die in den Puffer kopiert werden, in Byte.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Die folgende Liste identifiziert die möglichen Fehlercodes:
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | clfsw32.h |
| Library | Clfsw32.lib |
| DLL- | Clfsw32.dll |