Fonction ClfsMgmtSetLogFileSizeAsClient (wdm.h)

  • Article

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]  PCLFS_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