DS_DOMAIN_CONTROLLER_INFO_3A structure (ntdsapi.h)

Article
02/29/2024

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

Syntaxe

typedef struct {
#if ...
  CHAR  *NetbiosName;
#if ...
  CHAR  *DnsHostName;
#if ...
  CHAR  *SiteName;
#if ...
  CHAR  *SiteObjectName;
#if ...
  CHAR  *ComputerObjectName;
#if ...
  CHAR  *ServerObjectName;
#if ...
  CHAR  *NtdsDsaObjectName;
#else
  LPSTR NetbiosName;
#endif
#else
  LPSTR DnsHostName;
#endif
#else
  LPSTR SiteName;
#endif
#else
  LPSTR SiteObjectName;
#endif
#else
  LPSTR ComputerObjectName;
#endif
#else
  LPSTR ServerObjectName;
#endif
#else
  LPSTR NtdsDsaObjectName;
#endif
  BOOL  fIsPdc;
  BOOL  fDsEnabled;
  BOOL  fIsGc;
  BOOL  fIsRodc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3A, *PDS_DOMAIN_CONTROLLER_INFO_3A;

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.

SiteObjectName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’objet de site sur 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.

NtdsDsaObjectName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’objet DSA NTDS 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, il n’est pas activé.

fIsGc

Valeur booléenne qui indique si le contrôleur de domaine est ou non un serveur de catalogue global. Si cette valeur est TRUE, le contrôleur de domaine est un serveur de catalogue global ; sinon, il ne s’agit pas d’un serveur de catalogue global.

fIsRodc

Valeur booléenne qui indique si le contrôleur de domaine est un contrôleur de domaine en lecture seule. Si cette valeur a la valeur TRUE, le contrôleur de domaine est un contrôleur de domaine en lecture seule ; sinon, il ne s’agit pas d’un contrôleur de domaine en lecture seule.

SiteObjectGuid

Contient le GUID de l’objet de site sur le contrôleur de domaine.

ComputerObjectGuid

Contient le GUID de l’objet ordinateur sur le contrôleur de domaine.

ServerObjectGuid

Contient le GUID de l’objet serveur sur le contrôleur de domaine.

NtdsDsaObjectGuid

Contient le GUID de l’objet DSA NTDS sur le contrôleur de domaine.

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.

Notes

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

Voir aussi

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

DsGetDomainControllerInfo

Partager via