Partager via

ClfsMgmtSetLogFileSizeAsClient, fonction (wdm.h)

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 par le biais d’un appel à la routine ClfsMgmtRegisterManagedClient.

[in] NewSizeInContainers

Taille souhaitée du journal, exprimée dans le 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 dans le nombre de conteneurs.

[in, optional] CompletionRoutine

Non utilisé.

[in, optional] CompletionRoutineData

Non utilisé.

Valeur de retour

La routine ClfsMgmtSetLogFileSizeAsClient retourne une valeur NTSTATUS.

Retourner le code 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
 L’ensemble de stratégies installé sur le journal n’est pas valide. Cela peut être dû à une stratégie ClfsMgmtPolicyAutoShrink non valide ou stratégie ClfsMgmtPolicyMaximumSize.
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 .

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows 7 et versions ultérieures de Windows.
plateforme cible Bureau
d’en-tête wdm.h
DLL Clfs.sys

Voir aussi

routines de bibliothèque de gestion CLFS