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

屬性數目—定義 keys 和 values 參數陣列中的元素數目。

keys

表示屬性索引鍵之字串值的陣列指標。

values

表示對應屬性值之字串值的陣列指標。

傳回值

從傳入參數建置之新配置的 DNS_SERVICE_INSTANCE 結構的指標。 您的應用程式負責呼叫 DnsServiceFreeInstance來釋放相關聯的記憶體。

言論

傳回結構的 dwInterfaceIndex 字段設定為 0。

要求