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 が返されると、lpdwBufferLengthlpBuffer に配置されるデータのサイズを指定します。 GetLastError がERROR_INSUFFICIENT_BUFFERを返す場合、このパラメーターは要求された情報を保持するために必要なバイト数を指します。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 特定のエラー メッセージを取得するには、 GetLastError を呼び出します。

注釈

指定したハンドル型に無効なオプション フラグが dwOption パラメーターに渡された場合、GetLastErrorERROR_INVALID_PARAMETERを返します。

詳細については、「
インターネット オプションの設定と取得

WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetQueryOption を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

一般的な関数

FtpGetFile

FtpPutFile

InternetConnect

InternetOpen

InternetSetOption

WinINet 関数