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

Vedi anche

Strutture del servizio directory

Dsgetdcname