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

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

pIp6

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

wPort

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

wPriority

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

wWeight

一个表示服务权重的 值。

dwPropertiesCount

属性数 - 定义 和 values 参数数组keys中的元素数。

keys

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

values

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

返回值

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

注解

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

要求