Partager via


DsGetDomainControllerInfoA, fonction (ntdsapi.h)

La fonction DsGetDomainControllerInfo récupère des données sur les contrôleurs de domaine dans un domaine.

Syntaxe

NTDSAPI DWORD DsGetDomainControllerInfoA(
  [in]  HANDLE hDs,
  [in]  LPCSTR DomainName,
  [in]  DWORD  InfoLevel,
  [out] DWORD  *pcOut,
  [out] VOID   **ppInfo
);

Paramètres

[in] hDs

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

[in] DomainName

Pointeur vers une chaîne terminée par null qui spécifie le nom de domaine.

[in] InfoLevel

Contient une valeur qui indique la version de la structure DS_DOMAIN_CONTROLLER_INFO à retourner. Il peut s’agir de l’une des valeurs suivantes.

1

La fonction fournit les données de domaine au format de structure DS_DOMAIN_CONTROLLER_INFO_1 .

2

La fonction fournit les données de domaine au format de structure DS_DOMAIN_CONTROLLER_INFO_2 .

3

La fonction fournit les données de domaine au format de structure DS_DOMAIN_CONTROLLER_INFO_3 .

[out] pcOut

Pointeur vers une variable DWORD qui reçoit le nombre d’éléments retournés dans le tableau ppInfo .

[out] ppInfo

Pointeur vers une variable pointeur qui reçoit un tableau de structures DS_DOMAIN_CONTROLLER_INFO_* . Le type de structures dans ce tableau est défini par le paramètre InfoLevel . L’appelant doit libérer ce tableau, lorsqu’il n’est plus nécessaire, à l’aide de la fonction DsFreeDomainControllerInfo .

Valeur retournée

Si la fonction retourne des données de contrôleur de domaine, la valeur de retour est ERROR_SUCCESS. Si l’appelant ne dispose pas des privilèges nécessaires pour accéder aux objets serveur, la valeur de retour est ERROR_SUCCESS, mais les structures DS_DOMAIN_CONTROLLER_INFO peuvent être vides.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Remarques

Notes

L’en-tête ntdsapi.h définit DsGetDomainControllerInfo 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

DS_DOMAIN_CONTROLLER_INFO_1

DS_DOMAIN_CONTROLLER_INFO_2

DS_DOMAIN_CONTROLLER_INFO_3

Fonctions de gestion des contrôleurs de domaine et de la réplication

DsBind

DsBindWithCred

DsFreeDomainControllerInfo