DsListRolesA, fonction (ntdsapi.h)

Article
03/06/2024

La fonction DsListRoles répertorie les rôles reconnus par le serveur.

Syntaxe

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

Paramètres

[in] hDs

Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred .

[out] ppRoles

Pointeur vers une variable qui reçoit un pointeur vers une structure de DS_NAME_RESULT contenant les rôles reconnus par le serveur. La structure retournée doit être libérée à l’aide de DsFreeNameResult.

Les index du tableau dans la structure DS_NAME_RESULT indiquent quelles données sont contenues par chaque élément du tableau. Les constantes suivantes peuvent être utilisées pour spécifier l’index souhaité pour un élément de données particulier.

DS_ROLE_DOMAIN_OWNER

Le serveur est propriétaire du domaine.

DS_ROLE_INFRASTRUCTURE_OWNER

Le serveur est propriétaire de l’infrastructure.

DS_ROLE_PDC_OWNER

Le serveur est propriétaire du contrôleur de domaine principal.

DS_ROLE_RID_OWNER

Le serveur est propriétaire du RID.

DS_ROLE_SCHEMA_OWNER

Le serveur est propriétaire du schéma.

Valeur retournée

Si la fonction retourne une liste de rôles, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Des erreurs de conversion de noms individuelles sont signalées dans la structure DS_NAME_RESULT retournée.

Remarques

Notes

L’en-tête ntdsapi.h définit DsListRoles en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	ntdsapi.h
Bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll

Voir aussi

DS_NAME_RESULT

Fonctions de gestion des contrôleurs de domaine et de la réplication

DsFreeNameResult

Partager via