Share via

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

返回值

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

备注

注意

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

要求

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

请参阅

目录服务函数

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree