DnsServiceConstructInstance 函数 (windns.h)

用于根据描述它的数据生成 DNS_SERVICE_INSTANCE 结构。

语法

PDNS_SERVICE_INSTANCE DnsServiceConstructInstance(
  PCWSTR       pServiceName,
  PCWSTR       pHostName,
  PIP4_ADDRESS pIp4,
  PIP6_ADDRESS pIp6,
  WORD         wPort,
  WORD         wPriority,
  WORD         wWeight,
  DWORD        dwPropertiesCount,
  PCWSTR       *keys,
  PCWSTR       *values
);

参数

pServiceName

一个表示服务名称的字符串。

pHostName

一个表示服务主机名称的字符串。

pIp4

指向表示服务关联的 IPv4 地址的 IP4_ADDRESS 结构的指针。

pIp6

指向表示服务关联的 IPv6 地址的 IP6_ADDRESS 结构的指针。

wPort

一个值,表示运行服务的端口。

wPriority

一个表示服务优先级的值。

wWeight

一个表示服务权重的值。

dwPropertiesCount

属性数 - 定义 keysvalues 参数数组中的元素数。

keys

指向表示属性键的字符串值的数组的指针。

values

指向表示相应属性值的字符串值的数组的指针。

返回值

指向从传入参数生成的新分配 DNS_SERVICE_INSTANCE 结构的指针。 应用程序负责通过调用 DnsServiceFreeInstance来释放关联的内存。

言论

返回结构的 dwInterfaceIndex 字段设置为 0。

要求

要求 价值
最低支持的客户端 Windows 10 [仅限桌面应用]
目标平台 窗户
标头 windns.h
dnsapi.lib
DLL dnsapi.dll