Compartir a través de


estructura DS_DOMAIN_CONTROLLER_INFO_3A (ntdsapi.h)

La estructura DS_DOMAIN_CONTROLLER_INFO_3 contiene datos sobre un controlador de dominio. La función DsGetDomainControllerInfo devuelve esta estructura.

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;
  BOOL  fIsRodc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3A, *PDS_DOMAIN_CONTROLLER_INFO_3A;

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.

fIsRodc

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

SiteObjectGuid

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

ComputerObjectGuid

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

ServerObjectGuid

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

NtdsDsaObjectGuid

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

Comentarios

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, vea el parámetro InfoLevel de DsGetDomainControllerInfo.

Nota

El encabezado ntdsapi.h define DS_DOMAIN_CONTROLLER_INFO_3 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 ntdsapi.h

Consulte también

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

DsGetDomainControllerInfo