ClfsMgmtSetLogFileSizeAsClient-Funktion (wdm.h)

Artikel
02/29/2024

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 CLFS-Protokoll (Common Log File System) darstellt, oder einen Stream innerhalb des Protokolls, dem Container hinzugefügt oder gelöscht werden. Der Wert dieses Parameters wird durch 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 durch 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 maximal 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

Nicht verwendet.

[in, optional] CompletionRoutineData

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-Parameters ist 1.
STATUS_INVALID_PARAMETER_2	Der Wert des Parameters NewSizeInContainers ist NULL.
STATUS_LOG_POLICY_INVALID	Der für das Protokoll installierte Richtliniensatz 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 NewSizeInContainers zu erreichen.
STATUS_LOG_POLICY_CONFLICT	Eine Richtlinie für das angegebene Protokoll verhinderte den Abschluss des Vorgangs. Dies kann auftreten, wenn die CLFS-Verwaltung dem Protokoll nicht genügend Container hinzufügen konnte, um den Wert in NewSizeInContainers zu erreichen. Dies kann auf einen Konflikt mit einer Richtlinie zurückzuführen sein, die vom Client festgelegt wurde.

Diese Routine kann auch andere NTSTATUS-Werte zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform	Desktop
Kopfzeile	wdm.h
DLL	Clfs.sys

Weitere Informationen

CLFS-Verwaltungsbibliotheksroutinen

Freigeben über