Fonction EnterCriticalPolicySection (userenv.h)
La fonction EnterCriticalPolicySection interrompt l’application de la stratégie pour permettre aux applications de lire les paramètres de stratégie en toute sécurité. Les applications appellent cette fonction si elles lisent plusieurs entrées de stratégie et doivent s’assurer que les paramètres ne sont pas modifiés pendant leur lecture. Ce mutex protège stratégie de groupe traitement pour toutes les extensions côté client stockées dans un objet stratégie de groupe (GPO).
Syntaxe
USERENVAPI HANDLE EnterCriticalPolicySection(
[in] BOOL bMachine
);
Paramètres
[in] bMachine
Valeur qui spécifie s’il faut arrêter l’application de la stratégie d’ordinateur ou de la stratégie utilisateur. Si cette valeur est TRUE, le système cesse d’appliquer la stratégie d’ordinateur. Si cette valeur est FALSE, le système cesse d’appliquer la stratégie utilisateur.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle pour une section de stratégie.
Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.
Remarques
La durée maximale pendant laquelle une application peut contenir une section critique est de 10 minutes. Après 10 minutes, le système libère la section critique et la stratégie peut être appliquée à nouveau.
Pour acquérir les objets de section critique de l’ordinateur et de l’utilisateur, achetez l’objet de section critique pour l’utilisateur avant d’acquérir l’objet de section critique pour l’ordinateur. Cela permet d’éviter une situation d’interblocage.
Pour fermer le handle, appelez la fonction LeaveCriticalPolicySection . Le handle de section de stratégie ne peut pas être utilisé dans d’autres fonctions Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | userenv.h |
| Bibliothèque | Userenv.lib |
| DLL | Userenv.dll |