structure DS_DOMAIN_CONTROLLER_INFO_1W (ntdsapi.h)

Article
11/20/2024

La structure DS_DOMAIN_CONTROLLER_INFO_1 contient des données sur un contrôleur de domaine. Cette structure est retournée par la fonction DsGetDomainControllerInfo.

Syntaxe

typedef struct {
#if ...
  WCHAR  *NetbiosName;
#if ...
  WCHAR  *DnsHostName;
#if ...
  WCHAR  *SiteName;
#if ...
  WCHAR  *ComputerObjectName;
#if ...
  WCHAR  *ServerObjectName;
#else
  LPWSTR NetbiosName;
#endif
#else
  LPWSTR DnsHostName;
#endif
#else
  LPWSTR SiteName;
#endif
#else
  LPWSTR ComputerObjectName;
#endif
#else
  LPWSTR ServerObjectName;
#endif
  BOOL   fIsPdc;
  BOOL   fDsEnabled;
} DS_DOMAIN_CONTROLLER_INFO_1W, *PDS_DOMAIN_CONTROLLER_INFO_1W;

Membres

NetbiosName

Pointeur vers une chaîne terminée par null qui spécifie le nom NetBIOS du contrôleur de domaine.

DnsHostName

Pointeur vers une chaîne terminée par null qui spécifie le nom d’hôte DNS du contrôleur de domaine.

SiteName

Pointeur vers une chaîne terminée par null qui spécifie le site auquel appartient le contrôleur de domaine.

ComputerObjectName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’objet ordinateur sur le contrôleur de domaine.

ServerObjectName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’objet serveur sur le contrôleur de domaine.

fIsPdc

Valeur booléenne qui indique si ce contrôleur de domaine est le contrôleur de domaine principal. Si cette valeur est TRUE, le contrôleur de domaine est le contrôleur de domaine principal ; sinon, le contrôleur de domaine n’est pas le contrôleur de domaine principal.

fDsEnabled

Valeur booléenne qui indique si le contrôleur de domaine est activé ou non. Si cette valeur est TRUE, le contrôleur de domaine est activé ; sinon, elle n’est pas activée.

Remarques

La fonction DsGetDomainControllerInfo peut retourner différentes versions de cette structure. Pour plus d’informations et une liste des versions actuellement prises en charge, consultez le paramètre InfoLevel de DsGetDomainControllerInfo.

Note

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

Voir aussi

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

DsGetDomainControllerInfo

Partager via