Función DsGetDomainControllerInfoA (ntdsapi.h)

Artículo
11/20/2024

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 de 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 siguientes valores.

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 de que recibe el número de elementos devueltos en matriz ppInfo.

[out] ppInfo

Puntero a una variable de puntero que recibe una matriz de DS_DOMAIN_CONTROLLER_INFO_* estructuras. 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 el uso de 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 es 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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
de la plataforma de destino de	Windows
encabezado de	ntdsapi.h
biblioteca de	Ntdsapi.lib
DLL de	Ntdsapi.dll