DOMAIN_CONTROLLER_INFOA struttura (dsgetdc.h)
La struttura DOMAIN_CONTROLLER_INFO viene usata con la funzione DsGetDcName per ricevere dati relativi a un controller di dominio.
Sintassi
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;
Members
DomainControllerName
Puntatore a una stringa con terminazione null che specifica il nome del computer del controller di dominio individuato. Il nome del computer restituito è preceduto da "\". Il nome di stile DNS, ad esempio , "\phoenix.fabrikam.com", viene restituito, se disponibile. Se il nome di stile DNS non è disponibile, viene restituito il nome in stile flat ,ad esempio "\phoenix". Questo esempio si applica se il dominio è un dominio Windows NT 4.0 o se il dominio non supporta la famiglia DI protocolli IP.
DomainControllerAddress
Puntatore a una stringa con terminazione null che specifica l'indirizzo del controller di dominio individuato. L'indirizzo è preceduto da "\". Questa stringa è uno dei tipi definiti dal membro DomainControllerAddressType .
DomainControllerAddressType
Indica il tipo di stringa contenuto nel membro DomainControllerAddress . Questo può essere uno dei valori seguenti.
DS_INET_ADDRESS
L'indirizzo è un indirizzo IP stringa ,ad esempio "\157.55.94.74") del controller di dominio.
DS_NETBIOS_ADDRESS
L'indirizzo è un nome NetBIOS, ad esempio "\phoenix", del controller di dominio.
DomainGuid
GUID del dominio. Questo membro è zero se il controller di dominio non ha un GUID di dominio; ad esempio, il controller di dominio non è un controller di dominio Windows 2000.
DomainName
Puntatore a una stringa con terminazione null che specifica il nome del dominio. Il nome di stile DNS, ad esempio, "fabrikam.com", viene restituito se disponibile. In caso contrario, viene restituito il nome in stile flat, ad esempio "fabrikam". Questo nome può essere diverso dal nome di dominio richiesto se il dominio è stato rinominato.
DnsForestName
Puntatore a una stringa con terminazione null che specifica il nome del dominio nella radice dell'albero DS. Il nome di stile DNS, ad esempio, "fabrikam.com", viene restituito se disponibile. In caso contrario, viene restituito il nome in stile flat, ad esempio "fabrikam".
Flags
Contiene un set di flag che descrivono il controller di dominio. Questo può essere zero o una combinazione di uno o più dei valori seguenti.
DS_DNS_CONTROLLER_FLAG
Il membro DomainControllerName è in formato DNS.
DS_DNS_DOMAIN_FLAG
Il membro DomainName è in formato DNS.
DS_DNS_FOREST_FLAG
Il membro DnsForestName è in formato DNS.
DS_CLOSEST_FLAG
Il controller di dominio si trova nello stesso sito del client.
DS_DS_FLAG
Il controller di dominio è un server del servizio directory per il dominio.
DS_FULL_SECRET_DOMAIN_6_FLAG
Il controller di dominio è un controller di dominio di Windows 2008 o versione successiva.
DS_GOOD_TIMESERV_FLAG
Il controller di dominio esegue un servizio ora di Windows affidabile per il dominio.
DS_GC_FLAG
Il controller di dominio è un server di catalogo globale per la foresta specificata da DnsForestName.
DS_KDC_FLAG
Il controller di dominio è un Centro distribuzione chiavi Kerberos per il dominio.
DS_LDAP_FLAG
Il server è un server LDAP.
DS_NDNC_FLAG
Il nome di dominio è un contesto di denominazione dell'applicazione (non dominio).
DS_PDC_FLAG
Il controller di dominio è il controller di dominio primario del dominio.
DS_SELECT_SECRET_DOMAIN_6_FLAG
Il controller di dominio è un controller di dominio windows 2008 o versione successiva di sola lettura.
DS_TIMESERV_FLAG
Il controller di dominio esegue il servizio ora di Windows per il dominio.
DS_WRITABLE_FLAG
Il controller di dominio ospita un servizio directory scrivibile (o SAM).
DcSiteName
Puntatore a una stringa con terminazione null che specifica il nome del sito in cui si trova il controller di dominio. Questo membro può essere NULL se il controller di dominio non è in un sito; ad esempio, il controller di dominio è un controller di dominio Windows NT 4.0.
ClientSiteName
Puntatore a una stringa con terminazione null che specifica il nome del sito a cui appartiene il computer. Il computer viene specificato nel parametro ComputerName passato a DsGetDcName. Questo membro può essere NULL se il sito che contiene il computer non può essere trovato; ad esempio, se l'amministratore del servizio di dominio non ha associato la subnet in cui si trova il computer con un sito valido.
Commenti
Nota
L'intestazione dsgetdc.h definisce DOMAIN_CONTROLLER_INFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | dsgetdc.h |