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

Consulte también

Funciones del servicio de directorio

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX