Función DsListServersForDomainInSiteA (ntdsapi.h)

La función DsListServersForDomainInSite enumera todos los servidores de un dominio de un sitio.

Sintaxis

NTDSAPI DWORD DsListServersForDomainInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           domain,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppServers
);

Parámetros

[in] hDs

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

[in] domain

Puntero a una cadena terminada en null que especifica el nombre de dominio. Esta cadena debe ser la misma que una de las cadenas devueltas por función DsListDomainsInSite.

[in] site

Puntero a una cadena terminada en null que especifica el nombre del sitio. Esta cadena se toma de la lista de nombres de sitio devueltos por la función DsListSites.

[out] ppServers

Puntero a un puntero a una estructura de DS_NAME_RESULT que recibe la lista de servidores del dominio. La estructura devuelta debe liberarse mediante la función DsFreeNameResult.

Valor devuelto

Si la función devuelve una lista de servidores, el valor devuelto es NO_ERROR. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Observaciones

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

Nota

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

Consulte también

DS_NAME_RESULT

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

DsFreeNameResult