DsGetDomainControllerInfoA, fonction (ntdsapi.h)

Article
03/04/2024

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