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。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 [仅限桌面应用] |
目标平台 | Windows |
标头 | windns.h |
Library | dnsapi.lib |
DLL | dnsapi.dll |