AddLogContainer-Funktion (clfsw32.h)

Fügt dem physischen Protokoll, das dem Protokollhandle zugeordnet ist, einen Container hinzu, wenn der aufrufende Prozess Schreibzugriff auf die BLF-Datei und die Möglichkeit hat, Dateien im Zielverzeichnis des Containers zu erstellen.

Diese Funktion unterscheidet sich von AddLogContainerSet, da sie nur einen Container hinzufügt. Um mehrere Container hinzuzufügen, ist es effizienter, AddLogContainerSet zu verwenden, sodass Sie mehrere Container hinzufügen können. Das Hinzufügen von Containern ermöglicht es einem Client, die Größe eines Protokolls zu erhöhen.

Syntax

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

Parameter

[in] hLog

Das Handle für ein geöffnetes Protokoll.

Das Handle muss aus CreateLogFile mit Schreibzugriff auf das Protokoll abgerufen werden. Die Clientanwendung muss über Schreibzugriff auf die BLF-Datei und die Möglichkeit verfügen, Dateien im Zielverzeichnis eines Containers zu erstellen.

[in, optional] pcbContainer

Der optionale Parameter, der die Größe des Containers in Bytes angibt.

Die Mindestgröße beträgt 512 KB für normale Protokolle und 1024 KB für multiplexte Protokolle. Die maximale Größe beträgt ca. 4 Gigabyte.

Dieser Parameter ist erforderlich, wenn die Container einem neu erstellten Protokoll hinzugefügt werden. Wenn ein Container bereits erstellt wurde, kann dieser Parameter NULL oder ein Wert sein, der mindestens so groß wie die Größe des ersten Containers ist.

Protokollcontainergrößen sind ein Vielfaches der Protokollregionsgröße (512 KB). Wenn Sie einer neuen Datei einen Container hinzufügen, rundet die AddLogContainer-Funktion die Größe des Containers auf die nächste Begrenzung von 512 KB auf und gibt diese Größe im Wert zurück, auf den pcbContainer verweist.

Wenn das Protokoll bereits über mindestens einen Container verfügt und der Wert von *pcbContainer mindestens so groß ist wie die aktuelle Containergröße, erstellt die Funktion alle Container mit der aktuellen internen Größe und gibt diese Größe in *pcbContainer zurück.

[in] pwszContainerPath

Ein Zeiger auf eine NULL-Zeichenfolge, die einen gültigen Pfad für den neuen Container auf einem Protokollvolume enthält.

[in, out, optional] pReserved

Reserviert. Legen Sie pReserved auf NULL fest.

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

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

Weitere Informationen

AddLogContainerSet

Allgemeine Protokolldateisystemfunktionen

CreateLogFile