IGPEInformation::GetDSPath-Methode (gpedit.h)

Artikel
02/29/2024

Die GetDSPath-Methode ruft den Active Directory-Pfad für den angegebenen Abschnitt des Gruppenrichtlinienobjekts 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

Empfängt den Active Directory-Pfad zum Stammverzeichnis des angeforderten Abschnitts. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] cchMaxPath

Gibt die Größe des pszPath-Parameters in Zeichen an.

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 für den angegebenen Abschnitt eines Gruppenrichtlinienobjekts abzurufen, können Sie die GetFileSysPath-Methode aufrufen.

Anforderungen

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