estructura DOMAIN_CONTROLLER_INFOA (dsgetdc.h)
La estructura
Sintaxis
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;
Miembros
DomainControllerName
Puntero a una cadena terminada en null que especifica el nombre de equipo del controlador de dominio detectado. El nombre de equipo devuelto tiene el prefijo "\". El nombre de estilo DNS, por ejemplo, "\phoenix.fabrikam.com", se devuelve, si está disponible. Si el nombre de estilo DNS no está disponible, se devuelve el nombre de estilo plano (por ejemplo, "\phoenix"). Este ejemplo se aplicaría si el dominio es un dominio de Windows NT 4.0 o si el dominio no admite la familia de protocolos IP.
DomainControllerAddress
Puntero a una cadena terminada en null que especifica la dirección del controlador de dominio detectado. La dirección tiene el prefijo "\". Esta cadena es uno de los tipos definidos por el miembro DomainControllerAddressType.
DomainControllerAddressType
Indica el tipo de cadena contenida en el miembro DomainControllerAddress. Puede ser uno de los siguientes valores.
DS_INET_ADDRESS
La dirección es una dirección IP de cadena (por ejemplo, "\157.55.94.74") del controlador de dominio.
DS_NETBIOS_ADDRESS
La dirección es un nombre NetBIOS, por ejemplo, "\phoenix" del controlador de dominio.
DomainGuid
GUID de
DomainName
Puntero a una cadena terminada en null que especifica el nombre del dominio. El nombre de estilo DNS, por ejemplo, "fabrikam.com", se devuelve si está disponible. De lo contrario, se devuelve el nombre de estilo plano, por ejemplo, "fabrikam". Este nombre puede ser diferente del nombre de dominio solicitado si se ha cambiado el nombre del dominio.
DnsForestName
Puntero a una cadena terminada en null que especifica el nombre del dominio en la raíz del árbol DS. El nombre de estilo DNS, por ejemplo, "fabrikam.com", se devuelve si está disponible. De lo contrario, se devuelve el nombre de estilo plano, por ejemplo, "fabrikam".
Flags
Contiene un conjunto de marcas que describen el controlador de dominio. Puede ser cero o una combinación de uno o varios de los valores siguientes.
DS_DNS_CONTROLLER_FLAG
El miembro DomainControllerName está en formato DNS.
DS_DNS_DOMAIN_FLAG
El miembro domainName de
DS_DNS_FOREST_FLAG
El miembro DnsForestName está en formato DNS.
DS_CLOSEST_FLAG
El controlador de dominio está en el mismo sitio que el cliente.
DS_DS_FLAG
El controlador de dominio es un servidor de servicio de directorio para el dominio.
DS_FULL_SECRET_DOMAIN_6_FLAG
El controlador de dominio es un controlador de dominio grabable de Windows 2008 o posterior.
DS_GOOD_TIMESERV_FLAG
El controlador de dominio ejecuta un servicio de hora de Windows confiable para el dominio.
DS_GC_FLAG
El controlador de dominio es un servidor de catálogo global para el bosque especificado por DnsForestName.
DS_KDC_FLAG
El controlador de dominio es un Centro de distribución de claves Kerberos para el dominio.
DS_LDAP_FLAG
El servidor es un servidor LDAP.
DS_NDNC_FLAG
El nombre de dominio es un contexto de nomenclatura de aplicación (no de dominio).
DS_PDC_FLAG
El controlador de dominio es el controlador de dominio principal del dominio.
DS_SELECT_SECRET_DOMAIN_6_FLAG
El controlador de dominio es un controlador de dominio de solo lectura de Windows 2008 o posterior.
DS_TIMESERV_FLAG
El controlador de dominio ejecuta el servicio de hora de Windows para el dominio.
DS_WRITABLE_FLAG
El controlador de dominio hospeda un servicio de directorio grabable (o SAM).
DcSiteName
Puntero a una cadena terminada en null que especifica el nombre del sitio donde se encuentra el controlador de dominio. Este miembro puede ser NULL si el controlador de dominio no está en un sitio; por ejemplo, el controlador de dominio es un controlador de dominio de Windows NT 4.0.
ClientSiteName
Puntero a una cadena terminada en NULL que especifica el nombre del sitio al que pertenece el equipo. El equipo se especifica en el parámetro ComputerName de pasado a DsGetDcName. Este miembro puede ser NULL si no se encuentra el sitio que contiene el equipo; Por ejemplo, si el administrador de DS no ha asociado la subred en la que está el equipo con un sitio válido.
Observaciones
Nota
El encabezado dsgetdc.h define DOMAIN_CONTROLLER_INFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| encabezado de |
dsgetdc.h |