Función DsListInfoForServerA (ntdsapi.h)

Artículo
03/05/2024

La función DsListInfoForServer enumera datos varios para un servidor.

Sintaxis

NTDSAPI DWORD DsListInfoForServerA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           server,
  [out] PDS_NAME_RESULTA *ppInfo
);

Parámetros

[in] hDs

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

[in] server

Puntero a una cadena terminada en null que especifica el nombre del servidor. Este nombre debe ser el mismo que una de las cadenas devueltas por la función DsListServersForDomainInSite o DsListServersInSite .

[out] ppInfo

Puntero a una variable que recibe un puntero a una estructura de DS_NAME_RESULT que contiene los datos del servidor. La estructura devuelta debe desasignarse mediante DsFreeNameResult.

Los índices de la matriz de la estructura DS_NAME_RESULT indican qué datos contienen cada elemento de matriz. Se pueden usar las siguientes constantes para especificar el índice deseado para un fragmento de datos determinado.

DS_LIST_ACCOUNT_OBJECT_FOR_SERVER

Nombre del objeto de cuenta para el controlador de dominio (DC).

DS_LIST_DNS_HOST_NAME_FOR_SERVER

Nombre de host DNS del controlador de dominio.

DS_LIST_DSA_OBJECT_FOR_SERVER

GUID del agente de servicio de directorio (DSA) para el controlador de dominio (DC).

Valor devuelto

Si la función devuelve datos del servidor, el valor devuelto se NO_ERROR.

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

Comentarios

Los errores de conversión de nombres individuales se notifican en la estructura de DS_NAME_RESULT devuelta.

Nota

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