通过

DsAddressToSiteNamesA 函数 （dsgetdc.h）

  • 项目

DsAddressToSiteNames 函数获取与指定地址对应的站点名称。

语法

DSGETDCAPI DWORD DsAddressToSiteNamesA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames
);

参数

[in, optional] ComputerName

指向以 null 结尾的字符串的指针，该字符串指定要处理此函数的远程服务器的名称。 此参数必须是域控制器的名称。 非域控制器可以通过调用 DsGetDcName 来查找域控制器来调用此函数。

[in] EntryCount

包含 SocketAddresses 数组中的元素数。

[in] SocketAddresses

包含包含要转换的地址的 SOCKET_ADDRESS 结构的数组。 此数组中的每个地址都必须是类型 AF_INET。 EntryCount 包含此数组中的元素数。

[out] SiteNames

接收包含地址的站点名称的以 null 结尾的字符串指针数组。 此数组中的每个元素对应于 SocketAddresses 数组中的同一元素。 如果相应的地址未映射到任何已知站点，或者地址条目的格式不正确，则元素 NULL。 调用方必须通过调用 netApiBufferFree不再需要此数组时释放此数组。

返回值

如果成功或 Win32 或 RPC 错误，则返回 NO_ERROR 否则返回。 以下列表列出了可能的错误代码。

言论

注意

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

要求

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

另请参阅

目录服务函数

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree