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 mit 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 Protokollstreams 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 der Eingabe die Größe des pinfoBuffer-Metadatenpuffers in Bytes angibt.

Bei der Ausgabe empfängt es die Menge an Informationen, die in den Puffer kopiert werden, in Bytes.

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.

In der folgenden Liste werden die möglichen Fehlercodes identifiziert:

Anforderungen

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

Weitere Informationen

CLFS_INFORMATION

Allgemeine Protokolldateisystemfunktionen

SECURITY_ATTRIBUTES