structure DS_DOMAIN_CONTROLLER_INFO_3W (ntdsapi.h)

Article
11/20/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 ...
  WCHAR  *NetbiosName;
#if ...
  WCHAR  *DnsHostName;
#if ...
  WCHAR  *SiteName;
#if ...
  WCHAR  *SiteObjectName;
#if ...
  WCHAR  *ComputerObjectName;
#if ...
  WCHAR  *ServerObjectName;
#if ...
  WCHAR  *NtdsDsaObjectName;
#else
  LPWSTR NetbiosName;
#endif
#else
  LPWSTR DnsHostName;
#endif
#else
  LPWSTR SiteName;
#endif
#else
  LPWSTR SiteObjectName;
#endif
#else
  LPWSTR ComputerObjectName;
#endif
#else
  LPWSTR ServerObjectName;
#endif
#else
  LPWSTR NtdsDsaObjectName;
#endif
  BOOL   fIsPdc;
  BOOL   fDsEnabled;
  BOOL   fIsGc;
  BOOL   fIsRodc;
  GUID   SiteObjectGuid;
  GUID   ComputerObjectGuid;
  GUID   ServerObjectGuid;
  GUID   NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3W, *PDS_DOMAIN_CONTROLLER_INFO_3W;

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, elle n’est pas activée.

fIsGc

Valeur booléenne qui indique si le contrôleur de domaine est 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 est 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 pour 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.

Note

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. 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