Función DsEnumerateDomainTrustsA (dsgetdc.h)

La función DsEnumerateDomainTrusts obtiene datos de confianza de dominio para un dominio especificado.

Sintaxis

DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
  [in, optional] LPSTR              ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSA *Domains,
  [out]          PULONG             DomainCount
);

Parámetros

[in, optional] ServerName

Puntero a una cadena terminada en null que especifica el nombre de un equipo en el dominio para obtener la información de confianza. Si este parámetro es NULL, se usa el nombre del equipo local. El autor de la llamada debe ser un usuario autenticado en este dominio.

Si este equipo es un controlador de dominio, esta función devuelve los datos de confianza inmediatamente. Si este equipo no es un controlador de dominio, esta función obtiene los datos de confianza de los datos almacenados en caché si los datos almacenados en caché no han expirado. Si los datos almacenados en caché han expirado, esta función obtiene los datos de confianza de un controlador de dominio en el dominio del que este equipo es miembro y actualiza la memoria caché. Los datos almacenados en caché expiran automáticamente después de cinco minutos.

[in] Flags

Contiene un conjunto de marcas que determina qué dominio confía en enumerar. Puede ser cero o una combinación de uno o varios de los valores siguientes.

DS_DOMAIN_DIRECT_INBOUND

Enumera los dominios que confían directamente en el dominio que tiene ServerName como miembro.

DS_DOMAIN_DIRECT_OUTBOUND

Enumerar dominios de confianza directa por el dominio que tiene ServerName como miembro.

DS_DOMAIN_IN_FOREST

Enumera los dominios que son miembros del mismo bosque que tiene ServerName como miembro.

DS_DOMAIN_NATIVE_MODE

Enumera los dominios en los que el dominio principal se ejecuta en modo nativo de Windows 2000.

DS_DOMAIN_PRIMARY

Enumera los dominios que son el dominio principal del dominio que tiene ServerName como miembro.

DS_DOMAIN_TREE_ROOT

Enumera los dominios que se encuentran en la raíz del bosque que tiene ServerName como miembro.

[out] Domains

Puntero a un valor de PDS_DOMAIN_TRUSTS que recibe una matriz de estructuras de DS_DOMAIN_TRUSTS . Cada estructura de esta matriz contiene datos de confianza sobre un dominio. El autor de la llamada debe liberar esta memoria cuando ya no sea necesaria llamando a NetApiBufferFree.

[out] DomainCount

Puntero a un valor de ULONG que recibe el número de elementos devueltos en la matriz Domains .

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente o si un código de error win32 de lo contrario. Los posibles códigos de error incluyen los enumerados en la lista siguiente.

Comentarios

Nota

El encabezado dsgetdc.h define DsEnumerateDomainTrusts 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	dsgetdc.h
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

DS_DOMAIN_TRUSTS

Funciones del servicio de directorio

NetApiBufferFree