Compartir a través de

Función DsListDomainsInSiteA (ntdsapi.h)

  • Artículo

La función DsListDomainsInSite enumera todos los dominios de un sitio.

Sintaxis

NTDSAPI DWORD DsListDomainsInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppDomains
);

Parámetros

[in] hDs

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

[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] ppDomains

Puntero a un puntero a una estructura de DS_NAME_RESULT que recibe la lista de dominios del sitio. Para liberar la estructura devuelta, llame a la función DsFreeNameResult .

Valor devuelto

Si la función devuelve una lista de dominios, 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.

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 DsListDomainsInSite 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

Consulte también

DS_NAME_RESULT

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

DsFreeNameResult