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

Article
08/24/2023

La méthode GetDSPath récupère le chemin Active Directory à la racine de la section GPO spécifiée.

Syntaxe

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

Paramètres

[in] dwSection

Spécifie la section objet de stratégie de groupe. 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

Pointeur vers une mémoire tampon qui reçoit le chemin, au format ADSI (LDAP://cn=user, ou=users, dc=coname, dc=com).

[in] cchMaxPath

Spécifie le nombre maximal de caractères pouvant être stockés dans la mémoire tampon 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 SDK de plateforme WinError.h.

Notes

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 disposent uniquement d’un stockage de système de fichiers.

Pour récupérer le chemin du système de fichiers à la racine d’une section GPO, vous pouvez appeler la méthode GetFileSysPath .

Spécifications


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