Share via

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

请参阅

目录服务函数

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX