Fonction RefreshPolicyEx (userenv.h)
La fonction RefreshPolicyEx entraîne l’application immédiate de la stratégie sur l’ordinateur. La fonction étendue vous permet de spécifier le type d’actualisation de stratégie à appliquer.
Syntaxe
USERENVAPI BOOL RefreshPolicyEx(
[in] BOOL bMachine,
[in] DWORD dwOptions
);
Paramètres
[in] bMachine
Spécifie s’il faut actualiser la stratégie d’ordinateur ou la stratégie utilisateur. Si cette valeur est TRUE, le système actualise la stratégie de l’ordinateur. Si cette valeur est FALSE, le système actualise la stratégie utilisateur.
[in] dwOptions
Spécifie le type d’actualisation de stratégie à appliquer. Ce paramètre peut être la valeur suivante.
RP_FORCE
Réappliquez toutes les stratégies même si aucune modification de stratégie n’a été détectée.
Notez que s’il existe des extensions côté client qui peuvent être appliquées au démarrage ou à l’ouverture de session (par exemple, une extension d’installation d’application), les extensions sont réappérées au prochain démarrage ou à l’ouverture de session, même si aucune modification de stratégie n’est détectée.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Si vous n’avez pas besoin de spécifier le paramètre dwOptions , vous pouvez appeler la fonction RefreshPolicy à la place.
Par défaut, la stratégie est réappliquée toutes les 90 minutes.
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 |