estructura DS_DOMAIN_CONTROLLER_INFO_2A (ntdsapi.h)

Artículo
11/20/2024

La estructura DS_DOMAIN_CONTROLLER_INFO_2 contiene datos sobre un controlador de dominio. Esta estructura la devuelve la función DsGetDomainControllerInfo.

Sintaxis

typedef struct {
#if ...
  CHAR  *NetbiosName;
#if ...
  CHAR  *DnsHostName;
#if ...
  CHAR  *SiteName;
#if ...
  CHAR  *SiteObjectName;
#if ...
  CHAR  *ComputerObjectName;
#if ...
  CHAR  *ServerObjectName;
#if ...
  CHAR  *NtdsDsaObjectName;
#else
  LPSTR NetbiosName;
#endif
#else
  LPSTR DnsHostName;
#endif
#else
  LPSTR SiteName;
#endif
#else
  LPSTR SiteObjectName;
#endif
#else
  LPSTR ComputerObjectName;
#endif
#else
  LPSTR ServerObjectName;
#endif
#else
  LPSTR NtdsDsaObjectName;
#endif
  BOOL  fIsPdc;
  BOOL  fDsEnabled;
  BOOL  fIsGc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_2A, *PDS_DOMAIN_CONTROLLER_INFO_2A;

Miembros

NetbiosName

Puntero a una cadena terminada en NULL que especifica el nombre NetBIOS del controlador de dominio.

DnsHostName

Puntero a una cadena terminada en NULL que especifica el nombre de host DNS del controlador de dominio.

SiteName

Puntero a una cadena terminada en NULL que especifica el sitio al que pertenece el controlador de dominio.

SiteObjectName

Puntero a una cadena terminada en null que especifica el nombre del objeto de sitio en el controlador de dominio.

ComputerObjectName

Puntero a una cadena terminada en null que especifica el nombre del objeto de equipo en el controlador de dominio.

ServerObjectName

Puntero a una cadena terminada en null que especifica el nombre del objeto de servidor en el controlador de dominio.

NtdsDsaObjectName

Puntero a una cadena terminada en null que especifica el nombre del objeto NTDS DSA en el controlador de dominio.

fIsPdc

Valor booleano que indica si este controlador de dominio es o no el controlador de dominio principal. Si este valor es TRUE, el controlador de dominio es el controlador de dominio principal; de lo contrario, el controlador de dominio no es el controlador de dominio principal.

fDsEnabled

Valor booleano que indica si el controlador de dominio está habilitado o no. Si este valor es TRUE, el controlador de dominio está habilitado; de lo contrario, no está habilitado.

fIsGc

Valor booleano que indica si el controlador de dominio es o no servidor de catálogo global. Si este valor es TRUE, el controlador de dominio es un servidor de catálogo global; de lo contrario, no es un servidor de catálogo global.

SiteObjectGuid

Contiene el GUID de para el objeto de sitio en el controlador de dominio.

ComputerObjectGuid

Contiene el GUID de para el objeto de equipo en el controlador de dominio.

ServerObjectGuid

Contiene el GUID de para el objeto de servidor en el controlador de dominio.

NtdsDsaObjectGuid

Contiene el GUID de para el objeto NTDS DSA en el controlador de dominio.

Observaciones

La función DsGetDomainControllerInfo puede devolver diferentes versiones de esta estructura. Para obtener más información y una lista de las versiones admitidas actualmente, consulte el parámetro InfoLevel de DsGetDomainControllerInfo.

Nota

El encabezado ntdsapi.h define DS_DOMAIN_CONTROLLER_INFO_2 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	ntdsapi.h

Consulte también

estructuras de administración de replicación y controlador de dominio

DsGetDomainControllerInfo

Compartir a través de