Share via

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 に設定されます。

要件

要件 値
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー windns.h
Library dnsapi.lib
[DLL] dnsapi.dll