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

関連項目

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery