InternetSetOptionA 関数 (wininet.h)

インターネット オプションを設定します。

構文

BOOL InternetSetOptionA(
  [in] HINTERNET hInternet,
  [in] DWORD     dwOption,
  [in] LPVOID    lpBuffer,
  [in] DWORD     dwBufferLength
);

パラメーター

[in] hInternet

情報を設定する処理。

[in] dwOption

設定するインターネット オプション。 オプション フラグ の値のいずれかを指定できます。

[in] lpBuffer

オプション設定を含むバッファーへのポインター。

[in] dwBufferLength

lpBuffer バッファーのサイズ。 lpBuffer に文字列が含まれている場合、サイズは TCHAR 内にありますlpBuffer に文字列以外のものが含まれている場合、サイズはバイト単位です。

戻り値

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

解説

設定できないオプション フラグが指定されている場合、GetLastError はエラー ERROR_INVALID_PARAMETERを返します。

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

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

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

Note

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

要件

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

関連項目

共通関数

FtpGetFile

FtpPutFile

InternetConnect

InternetOpen

InternetQueryOption

WinINet 関数