InternetQueryOptionW

指定したハンドル上のインターネットオプションを問い合わせる。(Unicode)

InternetQueryOptionW hInternet, dwOption, lpBuffer, lpdwBufferLength

hInternet : [intptr] 情報を問い合わせる対象のハンドル。
dwOption : [int] 問い合わせるインターネットオプション。Option Flags 値のいずれかを指定できる。
lpBuffer : [intptr] オプション設定を受け取るバッファへのポインタ。InternetQueryOption が返す文字列はグローバルに割り当てられているため、呼び出し側アプリケーションは使用が終わったらそれらを解放しなければならない。
lpdwBufferLength : [var] lpBuffer のサイズ (バイト単位) を格納する変数へのポインタ。InternetQueryOption が戻ると、lpdwBufferLength には lpBuffer に格納されたデータのサイズが指定される。GetLastError が ERROR_INSUFFICIENT_BUFFER を返した場合、本パラメータは要求された情報を保持するために必要なバイト数を指す。

(プラグイン / モジュール : wininet.dll)

解説

指定したハンドル上のインターネットオプションを問い合わせる。(Unicode)

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。具体的なエラーメッセージを取得するには GetLastError
を呼び出す。

[備考]
指定したハンドル種別に対して無効なオプションフラグが dwOption パラメータに渡された場合、GetLastError は
ERROR_INVALID_PARAMETER を返す。詳細は Setting and Retrieving Internet
Options を参照のこと。WinINet API の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetQueryOption
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報