SetLogFileSizeWithPolicy-Funktion (clfsmgmtw32.h)

Artikel
08/22/2023

Fügt Container aus einem Protokoll basierend auf dem Status der installierten Richtlinien hinzu oder löscht sie.

Syntax

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

Parameter

[in] hLog

Ein Handle für ein Protokoll.

[in] pDesiredSize

Ein Zeiger auf einen Wert, der die angeforderte Protokollgröße angibt, ausgedrückt als einer der folgenden Werte. Die tatsächliche resultierende Größe finden Sie im Parameter pResultingSize .

Wert	Bedeutung
0	Erzwingen Sie die Mindestgrößesrichtlinie. Wenn eine Richtlinie für die Mindestgröße nicht installiert ist, tritt eine der folgenden Aktionen auf: Wenn das Protokoll über weniger als zwei Container verfügt, wird das Protokoll auf eine Größe von zwei Containern erweitert. Wenn das Protokoll über zwei oder mehr Container verfügt, werden keine Änderungen vorgenommen, und der Funktionsaufruf ist erfolgreich. Wenn eine Richtlinie für eine Mindestgröße installiert ist, tritt eine der folgenden Aktionen auf: Wenn das Protokoll weniger als die Mindestanzahl von Containern aufweist, die in der Richtlinie für die Mindestgröße angegeben sind, wird das Protokoll auf die von der Richtlinie angegebene Mindestanzahl von Containern erweitert. Wenn das Protokoll eine Anzahl von Containern aufweist, die größer als oder gleich der Mindestanzahl von Containern ist, die in der Richtlinie für die Mindestgröße angegeben sind, werden keine Änderungen vorgenommen, und der Funktionsaufruf ist ohne Fehler erfolgreich. Weitere Informationen finden Sie unter InstallLogPolicy.
1	Kein gültiger Wert; Der Funktionsaufruf schlägt mit ERROR_INVALID_PARAMETER fehl.
2–1023	Die gewünschte Größe des Protokolls, ausgedrückt als Die Anzahl der Container. Wenn diese Zahl kleiner als die mindeste Anzahl von Containern ist, die in der installierten Richtlinie angegeben ist, schlägt der Funktionsaufruf mit ERROR_COULD_NOT_RESIZE_LOG fehl. Wenn diese Zahl größer als die maximale Anzahl von Containern ist, die in der installierten Richtlinie angegeben ist, wird das Protokoll nur bis zur von der Richtlinie angegebenen maximalen Anzahl von Containern erweitert, und die Funktion ist ohne Fehler erfolgreich.
1024–MAXULONGLONG	Wenn keine Richtlinie für maximale Größe installiert ist, schlägt der Funktionsaufruf mit ERROR_LOG_POLICY_CONFLICT fehl. Wenn eine Richtlinie für maximale Größe installiert ist, wird das Protokoll auf die maximale Anzahl von Containern erweitert, die in der Richtlinie für maximale Größe angegeben sind, und die Funktion ist ohne Fehler erfolgreich.

[out] pResultingSize

Ein Zeiger auf eine gültige ULONGLONG-Datenvariable empfängt die Anzahl von Containern im Protokoll mit geänderter Größe nach erfolgreichem Erfolg.

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 die GetLastError-Funktion auf.

Hinweise

Container werden mit den gleichen Sicherheitsattributen wie die BLF-Datei erstellt und im Kontext der Anwendung erstellt, nicht im Kontext des Besitzers der BLF-Datei. Weitere Informationen zu BLF-Dateien finden Sie unter Protokolltypen. Wenn Container gelöscht werden, werden sie mithilfe des Sicherheitskontexts der aufrufenden Anwendung gelöscht.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Erstellen einer Protokolldatei.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	clfsmgmtw32.h
Bibliothek	Clfsw32.lib
DLL	Clfsw32.dll

Weitere Informationen

Erstellen einer Protokolldatei

InstallLogPolicy

Protokolltypen

Freigeben über