Méthode IGPEInformation::GetHint (gpedit.h)

La méthode GetHint récupère le type d’objet Active Directory auquel cet objet de stratégie de groupe peut être lié.

Syntaxe

HRESULT GetHint(
  [out] GROUP_POLICY_HINT_TYPE *gpHint
);

Paramètres

[out] gpHint

Reçoit le type de service d’annuaire. Ce paramètre peut prendre les valeurs suivantes.

GPHintUnknown

Aucune information de lien n’est disponible.

GPHintMachine

L’objet peut être lié à un ordinateur (local ou distant).

GPHintSite

L’objet peut être lié à un site.

GPHintDomain

L’objet peut être lié à un domaine.

GPHintOrganizationalUnit

L’objet peut être lié à une unité organisationnelle.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans le fichier d’en-tête du KIT de développement logiciel (SDK) de plateforme WinError.h.

Notes

L’éditeur d’objets stratégie de groupe ne peut pas déterminer quels objets Active Directory sont liés à un objet de stratégie de groupe particulier. La méthode GetHint fournit des informations de liaison en fonction de la façon dont l’utilisateur a démarré l’éditeur d’objets stratégie de groupe. Il peut être démarré des manières suivantes :

• En tant qu’extension du Gestionnaire Active Directory. Accédez au site, au domaine ou à l’unité organisationnelle, puis sélectionnez stratégie de groupe.
• En tant qu’outil MMC autonome avec un lien spécifique.
• En tant qu’outil MMC autonome sans lien spécifique.

Vous pouvez personnaliser l’interface utilisateur de votre application en fonction du résultat de l’appel de cette méthode. Toutefois, utilisez cette méthode avec précaution, car la valeur retournée peut indiquer l’étendue incorrecte.

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	gpedit.h
DLL	Gpedit.dll

Voir aussi

interfaces stratégie de groupe

Vue d’ensemble de la stratégie de groupe

IGPEInformation