DsEnumerateDomainTrustsA 函数 (dsgetdc.h)

项目
02/27/2024

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

语法

DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
  [in, optional] LPSTR              ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSA *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 值的指针，该值接收 Domains 数组中返回的元素数。

返回值

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

注解

注意

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

要求

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

另请参阅

DS_DOMAIN_TRUSTS

目录服务函数

NetApiBufferFree

通过