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 に設定します。
[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
戻り値
正常に完了すると、成功の確認を返します。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードを返します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | windns.h |
| ライブラリ | Dnsapi.lib |
| DLL | Dnsapi.dll |