estructura DOMAIN_CONTROLLER_INFOA (dsgetdc.h)
La estructura DOMAIN_CONTROLLER_INFO se usa con la función DsGetDcName para recibir datos sobre un controlador de dominio.
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 del 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 ip de protocolos.
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 que se encuentra en el miembro DomainControllerAddress . Puede ser uno de los valores siguientes.
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 del dominio. Este miembro es cero si el controlador de dominio no tiene un GUID de dominio; por ejemplo, el controlador de dominio no es un controlador de dominio de Windows 2000.
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 de 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 está en formato DNS.
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 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.
Comentarios
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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | dsgetdc.h |