Partager via


Méthode IGroupPolicyObject ::GetName (gpedit.h)

La méthode GetName récupère le nom unique de l’objet de stratégie de groupe.

Pour les objets de stratégie Active Directory, la méthode retourne un GUID. Pour un objet de stratégie de groupe local, la méthode retourne la chaîne « Local ». Pour les objets distants, GetName renvoie le nom de l’ordinateur.

Syntaxe

HRESULT GetName(
  [out] LPOLESTR pszName,
  [in]  int      cchMaxLength
);

Paramètres

[out] pszName

Pointeur vers une mémoire tampon qui reçoit le nom de l’objet de stratégie de groupe.

[in] cchMaxLength

Spécifie la taille, en caractères, de la mémoire tampon pszName .

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 SDK de plateforme WinError.h.

Remarques

Pour récupérer le nom complet d’un objet de stratégie de groupe, vous pouvez appeler la méthode GetDisplayName .

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 gpedit.h
DLL Gpedit.dll

Voir aussi

GetDisplayName

interfaces stratégie de groupe

Vue d’ensemble de la stratégie de groupe

IGroupPolicyObject