DsAddressToSiteNamesExA 函数 （dsgetdc.h）
DsAddressToSiteNamesEx 函数获取与指定地址对应的站点和子网名称。
语法
DSGETDCAPI DWORD DsAddressToSiteNamesExA(
[in, optional] LPCSTR ComputerName,
[in] DWORD EntryCount,
[in] PSOCKET_ADDRESS SocketAddresses,
[out] LPSTR **SiteNames,
[out] LPSTR **SubnetNames
);
参数
[in, optional] ComputerName
指向以 null 结尾的字符串的指针，该字符串指定要处理此函数的远程服务器的名称。 此参数必须是域控制器的名称。 非域控制器可以通过调用 DsGetDcName 来查找域控制器来调用此函数。
[in] EntryCount
包含 SocketAddresses 数组中的元素数。
[in] SocketAddresses
包含包含要转换的地址的 SOCKET_ADDRESS 结构的数组。 此数组中的每个地址都必须是类型 AF_INET。 EntryCount 包含此数组中的元素数。
[out] SiteNames
接收包含地址的站点名称的以 null 结尾的字符串指针数组。 此数组中的每个元素对应于 SocketAddresses 数组中的同一元素。 如果相应的地址未映射到任何已知站点，或者地址条目的格式不正确，则元素 NULL。 调用方必须通过调用 netApiBufferFree不再需要此数组时释放此数组。
[out] SubnetNames
接收以 null 结尾的字符串指针数组，其中包含用于执行站点名称映射地址的子网名称。 此数组中的每个元素对应于 SocketAddresses 数组中的同一元素。 如果未确定站点名称映射的相应地址，或者未使用子网执行相应的地址到站点映射，则元素 NULL。 当企业中只有一个站点没有映射到它的子网对象时，后者就是这种情况。 调用方必须通过调用 netApiBufferFree不再需要此数组时释放此数组。
返回值
如果成功或 Win32 或 RPC 错误，则返回 NO_ERROR 否则返回。 以下是可能的错误代码。
言论
注意
dsgetdc.h 标头将 DsAddressToSiteNamesEx 定义为基于 UNICODE 预处理器常量定义自动选择此函数的 ANSI 或 Unicode 版本的别名。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | dsgetdc.h |
| 库 | Netapi32.lib |
| DLL | Netapi32.dll |