Fonction ClfsMgmtSetLogFileSizeAsClient (wdm.h)

Article
02/27/2024

La routine ClfsMgmtSetLogFileSizeAsClient définit la taille du fichier journal en ajoutant des conteneurs à un journal client ou en supprimant des conteneurs d’un journal client.

Syntaxe

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
);

Paramètres

[in] LogFile

Pointeur vers une structure LOG_FILE_OBJECT qui représente le journal CLFS (Common Log File System) ou un flux dans le journal auquel les conteneurs sont ajoutés ou supprimés. La valeur de ce paramètre est obtenue via un appel à la routine ClfsCreateLogFile .

[in, optional] ClientCookie

Pointeur vers un cookie fourni par le client. La valeur de ce paramètre doit être la structure CLFS_MGMT_CLIENT obtenue via un appel à la routine ClfsMgmtRegisterManagedClient .

[in] NewSizeInContainers

Taille souhaitée du journal, exprimée en nombre de conteneurs. Il peut y avoir au maximum 1 024 conteneurs pour un fichier journal.

[out, optional] ResultingSizeInContainers

Taille réelle du journal, exprimée en nombre de conteneurs.

[in, optional] CompletionRoutine

Non utilisé.

[in, optional] CompletionRoutineData

Non utilisé.

Valeur retournée

La routine ClfsMgmtSetLogFileSizeAsClient retourne une valeur NTSTATUS.

Code de retour	Description
STATUS_SUCCESS	La taille du fichier journal a été définie.
STATUS_INVALID_PARAMETER_1	La valeur du paramètre LogFile est NULL ou le contenu du paramètre NewSizeInContainers est 1.
STATUS_INVALID_PARAMETER_2	La valeur du paramètre NewSizeInContainers est NULL.
STATUS_LOG_POLICY_INVALID	Le jeu de stratégies installé sur le journal n'est pas valide. Cela peut être dû à une stratégie ClfsMgmtPolicyAutoShrink ou une stratégie ClfsMgmtPolicyMaximumSize non valide.
STATUS_COULD_NOT_RESIZE_LOG	La gestion CLFS n’a pas pu supprimer suffisamment de conteneurs pour atteindre la valeur dans NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT	Une stratégie sur le journal spécifié a empêché l’opération de se terminer. Cela peut se produire si la gestion CLFS n’a pas pu ajouter suffisamment de conteneurs au journal pour atteindre la valeur dans NewSizeInContainers. Cela peut être dû à un conflit avec une stratégie définie par le client.

Cette routine peut également retourner d’autres valeurs NTSTATUS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 7 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h
DLL	Clfs.sys

Voir aussi

Routines de la bibliothèque de gestion CLFS

Partager via