ClfsMgmtSetLogFileSizeAsClient-Funktion (wdm.h)

Artikel
02/07/2025

Die ClfsMgmtSetLogFileSizeAsClient Routine legt die Protokolldateigröße fest, indem Container zu einem Clientprotokoll hinzugefügt oder Container aus einem Clientprotokoll gelöscht werden.

Syntax

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
  [in]            PLOG_FILE_OBJECT                     LogFile,
  [in, optional]  CLFS_MGMT_CLIENT                     ClientCookie,
  [in]            PULONGLONG                           NewSizeInContainers,
  [out, optional] PULONGLONG                           ResultingSizeInContainers,
  [in, optional]  PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
  [in, optional]  PVOID                                CompletionRoutineData
);

Parameter

[in] LogFile

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die das Common Log File System (CLFS)-Protokoll oder einen Datenstrom im Protokoll darstellt, zu der Container hinzugefügt oder gelöscht werden. Der Wert dieses Parameters wird über einen Aufruf der ClfsCreateLogFile Routine abgerufen.

[in, optional] ClientCookie

Ein Zeiger auf ein vom Client bereitgestelltes Cookie. Der Wert dieses Parameters sollte die CLFS_MGMT_CLIENT Struktur sein, die über einen Aufruf der ClfsMgmtRegisterManagedClient Routine abgerufen wird.

[in] NewSizeInContainers

Die gewünschte Größe des Protokolls, ausgedrückt in der Anzahl der Container. Es können höchstens 1.024 Container für eine Protokolldatei vorhanden sein.

[out, optional] ResultingSizeInContainers

Die tatsächliche Größe des Protokolls, ausgedrückt in der Anzahl der Container.

[in, optional] CompletionRoutine

Wird nicht verwendet.

[in, optional] CompletionRoutineData

Wird nicht verwendet.

Rückgabewert

Die ClfsMgmtSetLogFileSizeAsClient Routine gibt einen NTSTATUS-Wert zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Größe der Protokolldatei wurde festgelegt.
STATUS_INVALID_PARAMETER_1	Der Wert des LogFile--Parameters ist NULL-, oder der Inhalt des NewSizeInContainers Parameter ist 1.
STATUS_INVALID_PARAMETER_2	Der Wert des NewSizeInContainers--Parameters ist NULL-.
STATUS_LOG_POLICY_INVALID	Der installierte Satz von Richtlinien im Protokoll ist ungültig. Dies kann auf eine ungültige ClfsMgmtPolicyAutoShrink Richtlinie oder ClfsMgmtPolicyMaximumSize Richtlinie zurückzuführen sein.
STATUS_COULD_NOT_RESIZE_LOG	Die CLFS-Verwaltung konnte nicht genügend Container löschen, um den Wert in NewSizeInContainerszu erreichen.
STATUS_LOG_POLICY_CONFLICT	Eine Richtlinie im angegebenen Protokoll hat verhindert, dass der Vorgang abgeschlossen wird. Dies kann vorkommen, wenn die CLFS-Verwaltung dem Protokoll nicht genügend Container hinzufügen konnte, um den Wert in NewSizeInContainerszu erreichen. Dies kann auf einen Konflikt mit einer Richtlinie zurückzuführen sein, die der Client festgelegt hat.

Diese Routine kann auch andere NTSTATUS-Wertezurückgeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h
DLL-	Clfs.sys

Siehe auch

CLFS-Verwaltungsbibliotheksroutinen

Freigeben über