DsGetForestTrustInformationW 函数 (dsgetdc.h)
DsGetForestTrustInformationW 函数获取指定域的林信任数据。
语法
DSGETDCAPI DWORD DsGetForestTrustInformationW(
[in, optional] LPCWSTR ServerName,
[in, optional] LPCWSTR TrustedDomainName,
[in] DWORD Flags,
[out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);
参数
[in, optional] ServerName
包含 DsGetForestTrustInformationW 远程连接到的域控制器的名称。 调用方必须是此服务器上的经过身份验证的用户。 如果此参数为 NULL，则使用本地服务器。
[in, optional] TrustedDomainName
包含要为其检索林信任数据的受信任域的 NETBIOS 或 DNS 名称。 此域必须具有 TRUST_ATTRIBUTE_FOREST_TRANSITIVE 信任属性。 有关详细信息，请参阅 TRUSTED_DOMAIN_INFORMATION_EX。
如果此参数为 NULL，则会检索 由 ServerName 托管的域的林信任数据。
[in] Flags
包含一组标志，用于修改此函数的行为。 此值可以为零或以下值。
DS_GFTI_UPDATE_TDO
如果设置了此标志， DsGetForestTrustInformationW 将更新 TrustedDomainName 参数标识的受信任域的林信任数据。 在这种情况下， TrustedDomainName 参数不能为 NULL。 调用方必须有权修改信任数据或 返回ERROR_ACCESS_DENIED 。
仅当 ServerName 指定域的主域控制器时，此标志才有效。
[out] ForestTrustInfo
指向 LSA_FOREST_TRUST_INFORMATION 结构指针的指针，该指针接收林信任数据，该数据描述 由 TrustedDomainName 指定的域声明的命名空间。 所有返回记录的 Time 成员将为零。
调用 NetApiBufferFree 不再需要此结构时，调用方必须释放此结构。
返回值
如果成功，则返回 NO_ERROR ，否则返回 Win32 错误代码。 可能的错误代码包括以下内容。
要求
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | dsgetdc.h |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |