structure DOMAIN_CONTROLLER_INFOW (dsgetdc.h)

La structure DOMAIN_CONTROLLER_INFO est utilisée avec la fonction DsGetDcName pour recevoir des données sur un contrôleur de domaine.

Syntaxe

typedef struct _DOMAIN_CONTROLLER_INFOW {
#if ...
  wchar_t *DomainControllerName;
#else
  LPWSTR  DomainControllerName;
#endif
#if ...
  wchar_t *DomainControllerAddress;
#else
  LPWSTR  DomainControllerAddress;
#endif
  ULONG   DomainControllerAddressType;
  GUID    DomainGuid;
#if ...
  wchar_t *DomainName;
#else
  LPWSTR  DomainName;
#endif
#if ...
  wchar_t *DnsForestName;
#else
  LPWSTR  DnsForestName;
#endif
  ULONG   Flags;
#if ...
  wchar_t *DcSiteName;
#else
  LPWSTR  DcSiteName;
#endif
#if ...
  wchar_t *ClientSiteName;
#else
  LPWSTR  ClientSiteName;
#endif
} DOMAIN_CONTROLLER_INFOW, *PDOMAIN_CONTROLLER_INFOW;

Membres

DomainControllerName

Pointeur vers une chaîne terminée par null qui spécifie le nom d’ordinateur du contrôleur de domaine découvert. Le nom de l’ordinateur retourné est précédé de « \ ». Le nom de style DNS, par exemple « \phoenix.fabrikam.com », est retourné, si disponible. Si le nom de style DNS n’est pas disponible, le nom de style plat (par exemple, « \phoenix ») est retourné. Cet exemple s’applique si le domaine est un domaine Windows NT 4.0 ou si le domaine ne prend pas en charge la famille IP de protocoles.

DomainControllerAddress

Pointeur vers une chaîne terminée par null qui spécifie l’adresse du contrôleur de domaine découvert. L’adresse est précédée de « \ ». Cette chaîne est l’un des types définis par le membre DomainControllerAddressType .

DomainControllerAddressType

Indique le type de chaîne contenu dans le membre DomainControllerAddress . Il peut s’agir de l’une des valeurs suivantes.

DS_INET_ADDRESS

L’adresse est une adresse IP de chaîne (par exemple, « \157.55.94.74 ») du contrôleur de domaine.

DS_NETBIOS_ADDRESS

L’adresse est un nom NetBIOS, par exemple, « \phoenix », du contrôleur de domaine.

DomainGuid

GUID du domaine. Ce membre est égal à zéro si le contrôleur de domaine n’a pas de GUID de domaine ; par exemple, le contrôleur de domaine n’est pas un contrôleur de domaine Windows 2000.

DomainName

Pointeur vers une chaîne terminée par null qui spécifie le nom du domaine. Le nom de style DNS, par exemple , « fabrikam.com », est retourné s’il est disponible. Sinon, le nom de style plat, par exemple « fabrikam », est retourné. Ce nom peut être différent du nom de domaine demandé si le domaine a été renommé.

DnsForestName

Pointeur vers une chaîne terminée par null qui spécifie le nom du domaine à la racine de l’arborescence DS. Le nom de style DNS, par exemple , « fabrikam.com », est retourné s’il est disponible. Sinon, le nom de style plat, par exemple « fabrikam » est retourné.

Flags

Contient un ensemble d’indicateurs qui décrivent le contrôleur de domaine. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DS_DNS_CONTROLLER_FLAG

Le membre DomainControllerName est au format DNS.

DS_DNS_DOMAIN_FLAG

Le membre DomainName est au format DNS.

DS_DNS_FOREST_FLAG

Le membre DnsForestName est au format DNS.

DS_CLOSEST_FLAG

Le contrôleur de domaine se trouve dans le même site que le client.

DS_DS_FLAG

Le contrôleur de domaine est un serveur de service d’annuaire pour le domaine.

DS_FULL_SECRET_DOMAIN_6_FLAG

Le contrôleur de domaine est un contrôleur de domaine windows 2008 ou version ultérieure pouvant être accessible en écriture.

DS_GOOD_TIMESERV_FLAG

Le contrôleur de domaine exécute un service de temps Windows fiable pour le domaine.

DS_GC_FLAG

Le contrôleur de domaine est un serveur de catalogue global pour la forêt spécifiée par DnsForestName.

DS_KDC_FLAG

Le contrôleur de domaine est un centre de distribution de clés Kerberos pour le domaine.

DS_LDAP_FLAG

Le serveur est un serveur LDAP.

DS_NDNC_FLAG

Le nom de domaine est un contexte de nommage d’application (non-domaine).

DS_PDC_FLAG

Le contrôleur de domaine est le contrôleur de domaine principal du domaine.

DS_SELECT_SECRET_DOMAIN_6_FLAG

Le contrôleur de domaine est un contrôleur de domaine Windows 2008 ou version ultérieure en lecture seule.

DS_TIMESERV_FLAG

Le contrôleur de domaine exécute le service de temps Windows pour le domaine.

DS_WRITABLE_FLAG

Le contrôleur de domaine héberge un service d’annuaire accessible en écriture (ou SAM).

DcSiteName

Pointeur vers une chaîne terminée par null qui spécifie le nom du site où se trouve le contrôleur de domaine. Ce membre peut avoir la valeur NULL si le contrôleur de domaine ne se trouve pas dans un site ; par exemple, le contrôleur de domaine est un contrôleur de domaine Windows NT 4.0.

ClientSiteName

Pointeur vers une chaîne terminée par null qui spécifie le nom du site auquel appartient l’ordinateur. L’ordinateur est spécifié dans le paramètre ComputerName passé à DsGetDcName. Ce membre peut avoir la valeur NULL si le site qui contient l’ordinateur est introuvable ; par exemple, si l’administrateur DS n’a pas associé le sous-réseau dans lequel se trouve l’ordinateur à un site valide.

Notes

Notes

L’en-tête dsgetdc.h définit DOMAIN_CONTROLLER_INFO comme un 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.

Spécifications

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	dsgetdc.h

Voir aussi

Structures du service d’annuaire

DsGetDcName