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

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

keys

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

values

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

傳回值

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

備註

傳回結構的 dwInterfaceIndex 欄位會設定為 0。

規格需求