IGroupPolicyObject::GetDSPath-Methode (gpedit.h)

Artikel
08/24/2023

Die GetDSPath-Methode ruft den Active Directory-Pfad zum Stammverzeichnis des angegebenen Gruppenrichtlinienobjektabschnitts ab.

Syntax

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

Parameter

[in] dwSection

Gibt den Abschnitt "Gruppenrichtlinienobjekt" an. Dieser Parameter kann einen der folgenden Werte annehmen.

GPO_SECTION_ROOT

Stammabschnitt

GPO_SECTION_USER

Abschnitt „Benutzer“

GPO_SECTION_MACHINE

Abschnitt "Computer"

[out] pszPath

Zeiger auf einen Puffer, der den Pfad im ADSI-Format empfängt (LDAP://cn=user, ou=users, dc=coname, dc=com).

[in] cchMaxPath

Gibt die maximale Anzahl von Zeichen an, die im pszPath-Puffer gespeichert werden können.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der COM-Fehlercodes zurück, die in der Platform SDK-Headerdatei WinError.h definiert sind.

Hinweise

Wenn Sie die GetDSPath-Methode aufrufen und ein Computer-GPO angeben, ist die Methode erfolgreich, aber bei der Rückgabe enthält der pszPath-Parameter eine leere Zeichenfolge. Dies liegt daran, dass Computer-GPOs keinen Active Directory-Speicher haben. sie verfügen nur über Dateisystemspeicher.

Um den Dateisystempfad zum Stammverzeichnis eines GPO-Abschnitts abzurufen, können Sie die GetFileSysPath-Methode aufrufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	gpedit.h
DLL	Gpedit.dll