ClfsMgmtInstallPolicy, fonction (wdm.h)

  • Article

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