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 またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
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 |