WinHttpQueryOption

WinHttpQueryOption 関数は、指定したハンドルに対してインターネットオプションを問い合わせる。

WinHttpQueryOption hInternet, dwOption, lpBuffer, lpdwBufferLength

hInternet : [intptr] 情報を問い合わせる HINTERNET ハンドル。これはオプションの内容に応じてセッションハンドルまたはリクエストハンドルのいずれかを指定できる点に注意。どのハンドルを使うかは Option Flags のトピックで確認する。
dwOption : [int] 問い合わせるインターネットオプションを含む unsigned long 整数値。Option Flags の値のいずれかを指定できる。
lpBuffer : [intptr] オプション設定を受け取るバッファへのポインタ。WinHttpQueryOption 関数が返す文字列はグローバルに割り当てられているので、呼び出し側アプリケーションは使い終わった後に GlobalFree で解放しなければならない。このパラメータを NULL に設定すると関数は FALSE を返す。その後 GetLastError を呼び出すと ERROR_INSUFFICIENT_BUFFER が返り、lpdwBufferLength には要求された情報を保持するのに必要なバイト数が格納される。
lpdwBufferLength : [var] lpBuffer の長さをバイト単位で含む unsigned long 整数変数へのポインタ。関数が戻るとき、変数には lpBuffer に格納されたデータの長さが格納される。GetLastError が ERROR_INSUFFICIENT_BUFFER を返した場合、このパラメータには要求された情報を保持するのに必要なバイト数が格納される。

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

解説

WinHttpQueryOption 関数は、指定したハンドルに対してインターネットオプションを問い合わせる。

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。特定のエラーメッセージを取得するには GetLastError
を呼び出す。返されるエラーコードには次のものがある:
（以下省略）

[備考]
WinHTTP が非同期モード (WinHttpOpen で WINHTTP_FLAG_ASYNC が設定されている状態)
で使われる場合でも、この関数は同期的に動作する。戻り値は成功または失敗を示す。拡張エラー情報は GetLastError で取得する。
指定したハンドルの種類に対して無効なオプションフラグが dwOption パラメータに渡された場合、GetLastError は
ERROR_INVALID_PARAMETER を返す。注: Windows XP および Windows 2000 については
WinHttp の開始ページの Run-Time Requirements セクションを参照。

情報