struttura DOMAIN_CONTROLLER_INFOA (dsgetdc.h)
La struttura
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;
Membri
DomainControllerName
Puntatore a una stringa con terminazione Null che specifica il nome computer del controller di dominio individuato. Il nome del computer restituito è preceduto da "\". Il nome in stile DNS, ad esempio "\phoenix.fabrikam.com", viene restituito, se disponibile. Se il nome in stile DNS non è disponibile, viene restituito il nome in stile flat ,ad esempio "\phoenix". Questo esempio si applica se il dominio è un dominio di 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. Può trattarsi di 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
GUI D
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. Può essere zero o una combinazione di uno o più dei valori seguenti.
DS_DNS_CONTROLLER_FLAG
Il membro DomainControllerName
DS_DNS_DOMAIN_FLAG
Il membro domainName
DS_DNS_FOREST_FLAG
Il membro DnsForestName
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 scrivibile 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 di 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 si trova 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 non è possibile trovare il sito che contiene il computer; ad esempio, se l'amministratore DS non ha associato la subnet in cui si trova il computer con un sito valido.
Osservazioni
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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| intestazione |
dsgetdc.h |