Share via

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 不再需要此数组时，调用方必须释放该数组。

返回值

如果成功，则返回 NO_ERROR ，否则返回 Win32 或 RPC 错误。 下面是可能的错误代码。

注解

注意

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

要求

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

另请参阅

目录服务函数

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree