DsListDomainsInSiteA, fonction (ntdsapi.h)

  • Article

La fonction DsListDomainsInSite répertorie tous les domaines d’un site.

Syntaxe

NTDSAPI DWORD DsListDomainsInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppDomains
);

Paramètres

[in] hDs

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

[in] site

Pointeur vers une chaîne terminée par null qui spécifie le nom du site. Cette chaîne est extraite de la liste des noms de sites retournés par la fonction DsListSites .

[out] ppDomains

Pointeur vers un pointeur vers une structure DS_NAME_RESULT qui reçoit la liste des domaines dans le site. Pour libérer la structure retournée, appelez la fonction DsFreeNameResult .

Valeur retournée

Si la fonction retourne une liste de domaines, 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 DsListDomainsInSite 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. 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