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 に設定されます。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 10 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | windns.h |
ライブラリ | dnsapi.lib |
DLL | dnsapi.dll |