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

Article
02/26/2024

La méthode GetDSPath récupère le chemin Active Directory pour la section spécifiée de l’objet de stratégie de groupe.

Syntaxe

HRESULT GetDSPath(
  [in]  DWORD    dwSection,
  [out] LPOLESTR pszPath,
  [in]  int      cchMaxPath
);

Paramètres

[in] dwSection

Spécifie la section GPO. Ce paramètre peut prendre les valeurs suivantes.

GPO_SECTION_ROOT

Section racine

GPO_SECTION_USER

Section Utilisateur

GPO_SECTION_MACHINE

Section Ordinateur

[out] pszPath

Reçoit le chemin Active Directory à la racine de la section demandée. Pour plus d'informations, consultez la section Notes qui suit.

[in] cchMaxPath

Spécifie la taille, en caractères, du paramètre pszPath .

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.

Remarques

Si vous appelez la méthode GetDSPath et spécifiez un objet de stratégie de groupe d’ordinateur, la méthode réussit, mais au retour, le paramètre pszPath contient une chaîne vide. Cela est dû au fait que les objets de stratégie de groupe d’ordinateur n’ont pas de stockage Active Directory ; ils n’ont que le stockage du système de fichiers.

Pour récupérer le chemin du système de fichiers pour la section spécifiée d’un objet de stratégie de groupe, vous pouvez appeler la méthode GetFileSysPath .

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