InternetQueryOptionA 関数 (wininet.h)
指定したハンドルのインターネット オプションに対してクエリを実行します。
構文
BOOL InternetQueryOptionA(
[in] HINTERNET hInternet,
[in] DWORD dwOption,
[out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength
);
パラメーター
[in] hInternet
情報のクエリを実行する対象を処理します。
[in] dwOption
クエリを実行するインターネット オプション。 これは、 オプション フラグ の値のいずれかです。
[out] lpBuffer
オプション設定を受け取るバッファーへのポインター。 InternetQueryOption によって返される文字列はグローバルに割り当てられるため、呼び出し元のアプリケーションは、使用が完了したときに解放する必要があります。
[in, out] lpdwBufferLength
lpBuffer のサイズを含む変数へのポインター (バイト単位)。 InternetQueryOption が返されると、lpdwBufferLength は lpBuffer に配置されるデータのサイズを指定します。 GetLastError がERROR_INSUFFICIENT_BUFFERを返す場合、このパラメーターは要求された情報を保持するために必要なバイト数を指します。
戻り値
成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 特定のエラー メッセージを取得するには、 GetLastError を呼び出します。
注釈
指定したハンドル型に無効なオプション フラグが dwOption パラメーターに渡された場合、GetLastError はERROR_INVALID_PARAMETERを返します。
詳細については、「
インターネット オプションの設定と取得。
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
注意
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetQueryOption を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wininet.h |
Library | Wininet.lib |
[DLL] | Wininet.dll |