ClfsMgmtInstallPolicy, fonction (wdm.h)

Article
08/08/2023

La routine ClfsMgmtInstallPolicy ajoute une structure CLFS_MGMT_POLICY à un journal physique.

Syntaxe

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

Paramètres

[in] LogFile

Pointeur vers une structure LOG_FILE_OBJECT qui représente le journal CLFS auquel cette instance de la structure CLFS_MGMT_POLICY s’appliquera. La stratégie s’applique à tous les flux du journal, même si un seul flux dans le journal a été spécifié.

[in] Policy

Pointeur vers une structure CLFS_MGMT_POLICY qui contient la stratégie à installer.

[in] PolicyLength

Longueur, en octets, de la structure pointée vers le paramètre Policy .

Valeur retournée

La routine ClfsMgmtInstallPolicy retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	La stratégie a été installée.
STATUS_INVALID_PARAMETER_1	Une valeur NULL a été fournie pour le paramètre LogFile .
STATUS_INVALID_PARAMETER_2	Une valeur NULL a été fournie pour le paramètre Policy .
STATUS_INVALID_PARAMETER_3	La valeur du paramètre PolicyLength est inférieure à la taille d’un instance de la structure CLFS_MGMT_POLICY.
STATUS_NOT_SUPPORTED	Le membre PolicyFlags du CLFS_MGMT_POLICY_STRUCTURE désigné par le paramètre Policy spécifie tout indicateur autre que LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER	une des conditions suivantes est vraie : Le membre Version du paramètre Policy n’est pas égal à CLFS_MGMT_POLICY_VERSION. La valeur du paramètre Policy est égale à ClfsMgmtPolicyInvalid. Le membrePolicyFlags du paramètre Policy spécifie tout indicateur autre que LOG_POLICY_OVERWRITE.
STATUS_LOG_POLICY_ALREADY_INSTALLED	Le journal a déjà une stratégie de ce type et l’indicateur LOG_POLICY_OVERWRITE n’est pas défini.
STATUS_INSUFFICIENT_RESOURCES	La mémoire est insuffisante pour terminer l’opération.

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

Remarques

Les stratégies sont volatiles. Lorsque tous les handles du journal sont fermés, les stratégies sont perdues. Vous devez installer des stratégies chaque fois que vous inscrivez le premier client.

Vous devez uniquement inscrire une structure CLFS_MGMT_POLICY dont le membre PolicyType est égal à ClfsMgmtPolicyNewContainerSize avant la création du premier conteneur dans le journal. Toutes les inscriptions suivantes sont ignorées.

La stratégie de journal installée s’applique au journal physique, même si le paramètre LogFile spécifie un flux de journal.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Voir aussi

CLFS_MGMT_POLICY

Partager via