Función DsGetForestTrustInformationW (dsgetdc.h)
La función DsGetForestTrustInformationW obtiene datos de confianza de bosque para un dominio especificado.
Sintaxis
DSGETDCAPI DWORD DsGetForestTrustInformationW(
[in, optional] LPCWSTR ServerName,
[in, optional] LPCWSTR TrustedDomainName,
[in] DWORD Flags,
[out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);
Parámetros
[in, optional] ServerName
Contiene el nombre del controlador de dominio al que DsGetForestTrustInformationW está conectado de forma remota. El autor de la llamada debe ser un usuario autenticado en este servidor. Si este parámetro es NULL, se usa el servidor local.
[in, optional] TrustedDomainName
Contiene el nombre NETBIOS o DNS del dominio de confianza para el que se van a recuperar los datos de confianza del bosque. Este dominio debe tener el atributo de confianza TRUST_ATTRIBUTE_FOREST_TRANSITIVE . Para obtener más información, consulte TRUSTED_DOMAIN_INFORMATION_EX.
Si este parámetro es NULL, se recuperan los datos de confianza del bosque para el dominio hospedado por ServerName .
[in] Flags
Contiene un conjunto de marcas que modifican el comportamiento de esta función. Puede ser cero o el valor siguiente.
DS_GFTI_UPDATE_TDO
Si se establece esta marca, DsGetForestTrustInformationW actualizará los datos de confianza del bosque del dominio de confianza identificado por el parámetro TrustedDomainName . En este caso, el parámetro TrustedDomainName no puede ser NULL. El autor de la llamada debe tener acceso para modificar los datos de confianza o se devuelve ERROR_ACCESS_DENIED .
Esta marca solo es válida si ServerName especifica el controlador de dominio principal del dominio.
[out] ForestTrustInfo
Puntero a un puntero de estructura LSA_FOREST_TRUST_INFORMATION que recibe los datos de confianza del bosque que describen los espacios de nombres reclamados por el dominio especificado por TrustedDomainName. El miembro Time de todos los registros devueltos será cero.
El autor de la llamada debe liberar esta estructura cuando ya no sea necesaria mediante una llamada a NetApiBufferFree.
Valor devuelto
Devuelve NO_ERROR si se ejecuta correctamente o si el código de error de Win32 no es correcto. Entre los posibles códigos de error se incluyen los siguientes.
Requisitos
| 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 |