DsListServersForDomainInSiteA, fonction (ntdsapi.h)

Article
11/20/2024

La fonction DsListServersForDomainInSite répertorie tous les serveurs d’un domaine d’un site.

Syntaxe

NTDSAPI DWORD DsListServersForDomainInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           domain,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppServers
);

Paramètres

[in] hDs

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

[in] domain

Pointeur vers une chaîne terminée par null qui spécifie le nom de domaine. Cette chaîne doit être identique à l’une des chaînes retournées par fonction DsListDomainsInSite.

[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 site 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 domaine. 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 DsListServersForDomainInSite 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

DS_NAME_RESULT

fonctions de gestion du contrôleur de domaine et de la réplication

DsFreeNameResult

Partager via