Freigeben über


IGPEInformation::GetDSPath-Methode (gpedit.h)

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

Weitere Informationen

GetFileSysPath

Gruppenrichtlinie Schnittstellen

Übersicht über Gruppenrichtlinien

IGPEInformation