DsListSitesA, fonction (ntdsapi.h)
La fonction DsListSites répertorie tous les sites de la forêt d’entreprise.
Syntaxe
NTDSAPI DWORD DsListSitesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *ppSites
);
Paramètres
[in] hDs
Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind ou DSBindWithCred .
[out] ppSites
Pointeur vers un pointeur vers une structure DS_NAME_RESULT qui reçoit la liste des sites de l’entreprise. Le nom du site est retourné au format de nom unique (DN). La structure retournée doit être libérée à l’aide de la fonction DsFreeNameResult .
Valeur retournée
Si la fonction retourne une liste de sites, 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
Des erreurs de conversion de noms individuelles sont signalées dans la structure DS_NAME_RESULT retournée.
Notes
L’en-tête ntdsapi.h définit DsListSites 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
Fonctions de gestion des contrôleurs de domaine et de la réplication