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 |