InternetQueryOptionW 関数 (wininet.h)

[アーティクル]
11/20/2024

指定したハンドルに対してインターネットオプションを照会します。

構文

BOOL InternetQueryOptionW(
  [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呼び出します。

備考

GetLastError は、指定されたハンドルの種類に対して無効なオプションフラグが dwOption パラメーターに渡された場合、ERROR_INVALID_PARAMETER を返します。

詳細については、次を参照してください。
インターネットオプションの設定と取得.

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

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

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	wininet.h
ライブラリ	Wininet.lib
DLL	Wininet.dll

次の方法で共有

InternetQueryOptionW 関数 (wininet.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース