AddLogContainer-Funktion (clfsw32.h)

Fügt dem physischen Protokoll einen Container hinzu, der dem Protokollhandle zugeordnet ist– wenn der aufrufe Prozess Schreibzugriff auf die BLF-Datei und die Möglichkeit zum Erstellen von Dateien im Zielverzeichnis des Containers hat.

Diese Funktion unterscheidet sich von AddLogContainerSet, da nur ein Container hinzugefügt wird. Um mehrere Container hinzuzufügen, ist es effizienter, AddLogContainerSet zu verwenden, sodass Sie mehrere Container hinzufügen können. Durch das Hinzufügen von Containern kann ein Client die Größe eines Protokolls erhöhen.

Syntax

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

Die Parameter

[in] hLog

Das Handle für ein geöffnetes Protokoll.

Das Handle muss von CreateLogFile mit Schreibzugriff auf das Protokoll abgerufen werden. Die Clientanwendung muss Schreibzugriff auf die BLF-Datei und die Möglichkeit zum Erstellen von Dateien im Zielverzeichnis eines Containers haben.

[in, optional] pcbContainer

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

Die Mindestgröße beträgt 512 KB für normale Protokolle und 1024 KB für Multiplexed-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 bereits ein Container erstellt wurde, kann dieser Parameter NULL oder ein Wert sein, der mindestens so groß ist wie die Größe des ersten Containers.

Protokollcontainergrößen sind Vielfache der Protokollbereichsgröß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 Grenze von 512 KB auf und gibt diese Größe im Wert zurück, auf den von pcbContainer verwiesen wird.

Wenn das Protokoll bereits über mindestens einen Behälter 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 mit Null beendete 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Die folgende Liste identifiziert die möglichen Fehlercodes:

Anforderungen

Siehe auch

AddLogContainerSet

Allgemeine Funktionen des Protokolldateisystems

CreateLogFile