Partager via


ClfsMgmtInstallPolicy, fonction (wdm.h)

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