DsListRolesW, fonction (ntdsapi.h)
La fonction DsListRoles répertorie les rôles reconnus par le serveur.
Syntaxe
NTDSAPI DWORD DsListRolesW(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTW *ppRoles
);
Paramètres
[in] hDs
Contient un handle de service d’annuaire obtenu à partir de la fonction
[out] ppRoles
Pointeur vers une variable qui reçoit un pointeur vers une structure DS_NAME_RESULT contenant les rôles que le serveur reconnaît. La structure retournée doit être libérée à l’aide de DsFreeNameResult.
Les index du tableau dans la structure DS_NAME_RESULT indiquent les données contenues par chaque élément de 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 possède le domaine.
DS_ROLE_INFRASTRUCTURE_OWNER
Le serveur possède l’infrastructure.
DS_ROLE_PDC_OWNER
Le serveur possède le contrôleur de domaine principal.
DS_ROLE_RID_OWNER
Le serveur possède le RID.
DS_ROLE_SCHEMA_OWNER
Le serveur possède le schéma.
Valeur de retour
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.
Les erreurs de conversion de noms individuelles sont signalées dans la structure de DS_NAME_RESULT retournée.
Remarques
Note
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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | ntdsapi.h |
| bibliothèque | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
Voir aussi
fonctions de gestion du contrôleur de domaine et de la réplication