Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Die Größe der Protokolldatei wurde festgelegt. |
|
Der Wert des LogFile--Parameters ist NULL-, oder der Inhalt des NewSizeInContainers Parameter ist 1. |
|
Der Wert des NewSizeInContainers--Parameters ist NULL-. |
|
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. |
|
Die CLFS-Verwaltung konnte nicht genügend Container löschen, um den Wert in NewSizeInContainerszu erreichen. |
|
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 |