DnsQueryConfig 関数 (windns.h)
DnsQueryConfig 関数を使用すると、アプリケーション プログラマはローカル コンピューターまたは特定のアダプターの構成を照会できます。
構文
DNS_STATUS DnsQueryConfig(
[in] DNS_CONFIG_TYPE Config,
[in] DWORD Flag,
[in, optional] PCWSTR pwsAdapterName,
[in, optional] PVOID pReserved,
[out] PVOID pBuffer,
[in, out] PDWORD pBufLen
);
パラメーター
[in] Config
クエリを実行する情報の構成の種類を指定するDNS_CONFIG_TYPE値。
[in] Flag
構成情報にメモリを割り当てるかどうかを示す 値。 [フラグ] を DNS_CONFIG_FLAG_ALLOC に設定してメモリを割り当てます。それ以外の場合は、0 に設定します。
メモLocalFree を使用して、割り当てられたメモリを解放します。
[in, optional] pwsAdapterName
クエリを実行するアダプター名を表す文字列へのポインター。
[in, optional] pReserved
将来利用するために予約されています。
[out] pBuffer
クエリ応答を受け取るバッファーへのポインター。 次の表は、 各 Config パラメーター値のバッファーのデータ型を示しています。
| Config パラメーター | バッファーのデータ型 |
|---|---|
| DnsConfigPrimaryDomainName_W | PWCHAR |
| DnsConfigPrimaryDomainName_A | PCHAR |
| DnsConfigPrimaryDomainName_UTF8 | PCHAR |
| DnsConfigAdapterDomainName_W | 未実装 |
| DnsConfigAdapterDomainName_A | 未実装 |
| DnsConfigAdapterDomainName_UTF8 | 未実装 |
| DnsConfigDnsServerList | IP4_ARRAY |
| DnsConfigSearchList | 未実装 |
| DnsConfigAdapterInfo | 未実装 |
| DnsConfigPrimaryHostNameRegistrationEnabled | DWORD |
| DnsConfigAdapterHostNameRegistrationEnabled | DWORD |
| DnsConfigAddressRegistrationMaxCount | DWORD |
| DnsConfigHostName_W | PWCHAR |
| DnsConfigHostName_A | PCHAR |
| DnsConfigHostName_UTF8 | PCHAR |
| DnsConfigFullHostName_W | PWCHAR |
| DnsConfigFullHostName_A | PCHAR |
| DnsConfigFullHostName_UTF8 | PCHAR |
[in, out] pBufLen
バッファーの長さ (バイト単位)。 指定されたバッファーで十分でない場合は、エラーが返され、 pBufferLength には必要最小限のバッファー サイズが含まれます。 Flag が TRUE に設定されている場合、入力時に無視されます。
戻り値
正常に完了すると、成功の確認を返します。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードを返します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | windns.h |
| Library | Dnsapi.lib |
| [DLL] | Dnsapi.dll |