InternetCheckConnectionW

アプリケーションがインターネットへの接続を確立できるかどうかをチェックできるようにする。(Unicode)

InternetCheckConnectionW lpszUrl, dwFlags, dwReserved

lpszUrl : [wstr] 接続をチェックするために使用する URL を指定する null 終端文字列へのポインタ。本値には NULL を指定できる。
dwFlags : [int] オプション。現在使用可能なフラグは FLAG_ICC_FORCE_CONNECTION のみである。このフラグが設定されると、接続が強制される。ソケット接続は次の順序で試みられる。
dwReserved : [int] 本パラメータは予約されており、0 を指定しなければならない。

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

解説

アプリケーションがインターネットへの接続を確立できるかどうかをチェックできるようにする。(Unicode)

[戻り値]
接続が成功した場合は TRUE を、そうでない場合は FALSE を返す。エラーコードを取得するには GetLastError
を使用する。接続できない場合、またはソケットデータベースが無条件にオフラインである場合、GetLastError は
ERROR_NOT_CONNECTED を返す。

[備考]
InternetCheckConnection は非推奨である。InternetCheckConnection
はインターネットへのアクセスに Web プロキシサーバーを使用する環境では機能しない。環境に応じて、代わりに
NetworkInformation.GetInternetConnectionProfile または NLM
インターフェイスを使用してインターネットアクセスをチェックすべきである。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetCheckConnection
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報