structure DOMAIN_CONTROLLER_INFOA (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_INFOA {
LPSTR DomainControllerName;
LPSTR DomainControllerAddress;
ULONG DomainControllerAddressType;
GUID DomainGuid;
LPSTR DomainName;
LPSTR DnsForestName;
ULONG Flags;
LPSTR DcSiteName;
LPSTR ClientSiteName;
} DOMAIN_CONTROLLER_INFOA, *PDOMAIN_CONTROLLER_INFOA;
Membres
DomainControllerName
Pointeur vers une chaîne terminée par null qui spécifie le nom de l’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é, le cas échéant. Si le nom du 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 d’adresses IP des 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é si 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é si 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 sur 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 accessible en écriture Windows 2008 ou version ultérieure.
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 être NULL si le contrôleur de domaine n’est 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 être 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 l’ordinateur se trouve avec un site valide.
Remarques
Note
L’en-tête dsgetdc.h définit DOMAIN_CONTROLLER_INFO 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 | dsgetdc.h |