Fonction de rappel PFNGENERATEGROUPPOLICY (userenv.h)

Article
03/03/2024

La fonction de rappel GenerateGroupPolicy est une fonction de rappel définie par l’application que chaque extension de stratégie doit exporter lors de la génération de données RSoP en mode planification. Le service d’accès aux données stratégie de groupe (GPDAS) appelle la fonction après que le service simule le chargement des extensions côté client afin que les extensions puissent générer des données de stratégie.

Le type PFNGENERATEGROUPPOLICY définit un pointeur vers cette fonction de rappel. GenerateGroupPolicy est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

PFNGENERATEGROUPPOLICY Pfngenerategrouppolicy;

DWORD Pfngenerategrouppolicy(
  [in] DWORD dwFlags,
  [in] BOOL *pbAbort,
  [in] WCHAR *pwszSite,
  [in] PRSOP_TARGET pComputerTarget,
  [in] PRSOP_TARGET pUserTarget
)
{...}

Paramètres

[in] dwFlags

Paramètre qui représente un ou plusieurs des indicateurs suivants.

GPO_INFO_FLAG_SLOWLINK

La stratégie est appliquée sur un lien lent.

GPO_INFO_FLAG_VERBOSE

Écrivez une sortie détaillée dans le journal des événements.

[in] pbAbort

Valeur qui spécifie s’il faut continuer à traiter les objets de stratégie de groupe. Si ce paramètre a la valeur TRUE, le traitement des objets de stratégie de groupe s’arrête et l’extension doit libérer ses ressources et retourner rapidement. Si ce paramètre a la valeur FALSE, le traitement des objets de stratégie de groupe continue.

[in] pwszSite

Pointeur vers le nom de site de l’ordinateur cible. Ce paramètre peut être NULL.

[in] pComputerTarget

Pointeur vers une structure de RSOP_TARGET qui contient des informations sur un ordinateur. Ce paramètre peut être NULL, mais s’il est NULL, le paramètre pUserTarget est obligatoire.

[in] pUserTarget

Pointeur vers une structure de RSOP_TARGET qui contient des informations sur un utilisateur. Ce paramètre peut être NULL, mais s’il est NULL, le paramètre pComputerTarget est obligatoire.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système ou le fichier d’en-tête WinError.h.

Remarques

L’extension de stratégie doit inscrire cette fonction de rappel à la clé de Registre :HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\GPExtensions\ClientExtensionGuid

GenerateGroupPolicyREG_SZ

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

Voir aussi

fonctions stratégie de groupe

Vue d’ensemble de la stratégie de groupe

RSOP_TARGET

Partager via