DsListServersInSiteA, fonction (ntdsapi.h)
La fonction DsListServersInSite répertorie tous les serveurs d’un site.
Syntaxe
NTDSAPI DWORD DsListServersInSiteA(
[in] HANDLE hDs,
[in] LPCSTR site,
[out] PDS_NAME_RESULTA *ppServers
);
Paramètres
[in] hDs
Contient un handle de service d’annuaire obtenu à partir de la fonction
[in] site
Pointeur vers une chaîne terminée par null qui spécifie le nom du site. Le nom du site utilise un format de nom unique. Elle est extraite de la liste des sites retournés par la fonction DsListSites.
[out] ppServers
Pointeur vers un pointeur vers une structure DS_NAME_RESULT qui reçoit la liste des serveurs dans le site. La structure retournée doit être libérée à l’aide de la fonction DsFreeNameResult.
Valeur de retour
Si la fonction retourne une liste de serveurs, la valeur de retour est NO_ERROR. Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.
Remarques
Les erreurs de conversion de noms individuelles sont signalées dans la structure de DS_NAME_RESULT retournée.
Note
L’en-tête ntdsapi.h définit DsListServersInSite comme 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