InternetOpenW

アプリケーションによる WinINet 関数の使用を初期化する。(Unicode)

InternetOpenW lpszAgent, dwAccessType, lpszProxy, lpszProxyBypass, dwFlags

lpszAgent : [wstr] WinINet 関数を呼び出すアプリ名または主体名を指定する NULL 終端文字列へのポインタ。HTTP の user agent として使用される。
dwAccessType : [int] 
lpszProxy : [wstr] dwAccessType が INTERNET_OPEN_TYPE_PROXY のときに使用するプロキシサーバー名を指定する NULL 終端文字列へのポインタ。空文字列は使わないこと。WinINet は HTTP の CERN 型プロキシと FTP の TIS FTP ゲートウェイのみ認識する。IE がインストールされていれば SOCKS プロキシも対応。それ以外の dwAccessType では無視され NULL 可。
lpszProxyBypass : [wstr] INTERNET_OPEN_TYPE_PROXY 時にプロキシ経由しないホスト名/IP アドレスのリスト(セミコロン区切り、ワイルドカード可)を指定する NULL 終端文字列へのポインタ。空文字列は使わないこと。"<local>" マクロを指定するとピリオドを含まないホスト名をバイパスする。既定で WinINet は "localhost"、"loopback"、"127.0.0.1"、"[::1]" のプロキシをバイパスする。"<-loopback>" マクロでローカルコンピュータをバイパスリストから除外できる (IE9)。それ以外の dwAccessType では無視され NULL 可。
dwFlags : [int] 

(プラグイン / モジュール : wininet.dll)

解説

アプリケーションによる WinINet 関数の使用を初期化する。(Unicode)

[戻り値]
成功時はアプリが後続の WinINet 関数に渡す有効なハンドルを返す。失敗時は NULL。特定のエラーメッセージは
GetLastError で取得する。

[備考]
InternetOpen はアプリケーションが最初に呼ぶ WinINet 関数。インターネット DLL
に内部データ構造を初期化させ後続呼び出しに備えさせる。使用終了時は InternetCloseHandle
でハンドルと関連リソースを解放する。複数回呼び出しも可能だが通常 1 回で十分。使用後は InternetCloseHandle
で閉じる。WinINet はサービスやサーバー実装から使用すべきでない。
> [!NOTE] > wininet.h は UNICODE マクロに応じて InternetOpen を ANSI/Unicode
版のエイリアスとして定義する。

情報