Función DsGetDomainControllerInfoA (ntdsapi.h)

Artículo
08/25/2023

La función DsGetDomainControllerInfo recupera datos sobre los controladores de dominio de un dominio.

Sintaxis

NTDSAPI DWORD DsGetDomainControllerInfoA(
  [in]  HANDLE hDs,
  [in]  LPCSTR DomainName,
  [in]  DWORD  InfoLevel,
  [out] DWORD  *pcOut,
  [out] VOID   **ppInfo
);

Parámetros

[in] hDs

Contiene un identificador de servicio de directorio obtenido de la función DSBind o DSBindWithCred .

[in] DomainName

Puntero a una cadena terminada en null que especifica el nombre de dominio.

[in] InfoLevel

Contiene un valor que indica la versión de la estructura DS_DOMAIN_CONTROLLER_INFO que se va a devolver. Puede ser uno de los valores siguientes.

1

La función proporciona los datos de dominio en el formato de estructura DS_DOMAIN_CONTROLLER_INFO_1 .

2

La función proporciona los datos de dominio en el formato de estructura DS_DOMAIN_CONTROLLER_INFO_2 .

3

La función proporciona los datos de dominio en el formato de estructura DS_DOMAIN_CONTROLLER_INFO_3 .

[out] pcOut

Puntero a una variable DWORD que recibe el número de elementos devueltos en la matriz ppInfo .

[out] ppInfo

Puntero a una variable de puntero que recibe una matriz de estructuras DS_DOMAIN_CONTROLLER_INFO_* . El tipo de estructuras de esta matriz se define mediante el parámetro InfoLevel . El autor de la llamada debe liberar esta matriz, cuando ya no es necesaria, mediante la función DsFreeDomainControllerInfo .

Valor devuelto

Si la función devuelve datos del controlador de dominio, el valor devuelto es ERROR_SUCCESS. Si el autor de la llamada no tiene los privilegios para acceder a los objetos de servidor, el valor devuelto se ERROR_SUCCESS, pero las estructuras de DS_DOMAIN_CONTROLLER_INFO podrían estar vacías.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Comentarios

Nota

El encabezado ntdsapi.h define DsGetDomainControllerInfo 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
Plataforma de destino	Windows
Encabezado	ntdsapi.h
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll