通过

DsEnumerateDomainTrustsW 函数 （dsgetdc.h）

  • 项目

DsEnumerateDomainTrusts 函数获取指定域的域信任数据。

语法

DSGETDCAPI DWORD DsEnumerateDomainTrustsW(
  [in, optional] LPWSTR             ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSW *Domains,
  [out]          PULONG             DomainCount
);

参数

[in, optional] ServerName

指向以 null 结尾的字符串的指针，该字符串指定要获取其信任信息的域中计算机的名称。 如果此参数 NULL，则使用本地计算机的名称。 调用方必须是此域中经过身份验证的用户。

如果此计算机是域控制器，则此函数会立即返回信任数据。 如果此计算机不是域控制器，则此函数从缓存的数据中获取信任数据（如果缓存的数据未过期）。 如果缓存的数据已过期，此函数将从此计算机所属的域中的域控制器获取信任数据，并更新缓存。 缓存的数据会在五分钟后自动过期。

[in] Flags

包含一组标志，用于确定要枚举的域信任。 这可以是零，也可以是以下一个或多个值的组合。

DS_DOMAIN_DIRECT_INBOUND

枚举直接信任 ServerName 作为成员的域。

DS_DOMAIN_DIRECT_OUTBOUND

枚举 ServerName 作为成员的域直接信任的域。

DS_DOMAIN_IN_FOREST

枚举属于 ServerName 作为成员的同一林的成员的域。

DS_DOMAIN_NATIVE_MODE

枚举主域在 Windows 2000 本机模式下运行的域。

DS_DOMAIN_PRIMARY

枚举作为成员 ServerName 的域的主域。

DS_DOMAIN_TREE_ROOT

枚举位于 ServerName 作为成员的林根目录的域。

[out] Domains

指向接收 DS_DOMAIN_TRUSTS 结构的数组的 PDS_DOMAIN_TRUSTS 值的指针。 此数组中的每个结构都包含有关域的信任数据。 调用方必须通过调用 netApiBufferFree不再需要此内存。

[out] DomainCount

指向 ULONG 值的指针，该值接收 域 数组中返回的元素数。

返回值

如果成功，则返回 ERROR_SUCCESS;否则返回 Win32 错误代码。 可能的错误代码包括以下列表中所列的错误代码。

言论

注意

dsgetdc.h 标头将 DsEnumerateDomainTrusts 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
目标平台 窗户
标头 dsgetdc.h
库 Netapi32.lib
DLL Netapi32.dll

另请参阅

DS_DOMAIN_TRUSTS

目录服务函数

NetApiBufferFree