DsListRolesA-Funktion (ntdsapi.h)

  • Artikel

Die DsListRoles-Funktion listet die vom Server erkannten Rollen auf.

Syntax

NTDSAPI DWORD DsListRolesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *ppRoles
);

Parameter

[in] hDs

Enthält ein Verzeichnisdiensthandle, das von der FUNKTION DSBind oder DSBindWithCred abgerufen wurde.

[out] ppRoles

Zeiger auf eine Variable, die einen Zeiger auf eine DS_NAME_RESULT Struktur empfängt, die die vom Server erkannten Rollen enthält. Die zurückgegebene Struktur muss mithilfe von DsFreeNameResult zugeordnet werden.

Die Indizes des Arrays in der DS_NAME_RESULT Struktur geben an, welche Daten in jedem Arrayelement enthalten sind. Die folgenden Konstanten können verwendet werden, um den gewünschten Index für eine bestimmte Datenmenge anzugeben.

DS_ROLE_DOMAIN_OWNER

Der Server besitzt die Domäne.

DS_ROLE_INFRASTRUCTURE_OWNER

Der Server besitzt die Infrastruktur.

DS_ROLE_PDC_OWNER

Der Server besitzt den PDC.

DS_ROLE_RID_OWNER

Der Server besitzt die RID.

DS_ROLE_SCHEMA_OWNER

Der Server besitzt das Schema.

Rückgabewert

Wenn die Funktion eine Liste von Rollen zurückgibt, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Fehler bei der Konvertierung einzelner Namen werden in der zurückgegebenen DS_NAME_RESULT-Struktur gemeldet.

Hinweise

Hinweis

Der ntdsapi.h-Header definiert DsListRoles als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile ntdsapi.h
Bibliothek Ntdsapi.lib
DLL Ntdsapi.dll

Weitere Informationen

DS_NAME_RESULT

Domänencontroller und Replikationsverwaltungsfunktionen

DsFreeNameResult