InternetCheckConnectionA 関数 (wininet.h)
[InternetCheckConnection は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 NetworkInformation.GetInternetConnectionProfile または NLM インターフェイスを使用します。 ]
インターネットへの接続を確立できるかどうかをアプリケーションがチェックできるようにします。
構文
BOOL InternetCheckConnectionA(
[in] LPCSTR lpszUrl,
[in] DWORD dwFlags,
[in] DWORD dwReserved
);
パラメーター
[in] lpszUrl
接続のチェックに使用する URL を指定する null で終わる文字列へのポインター。 この値には NULL を指定できます。
[in] dwFlags
オプション。 FLAG_ICC_FORCE_CONNECTIONは、現在使用できる唯一のフラグです。 このフラグを設定すると、強制的に接続されます。 ソケット接続は次の順序で試行されます。
- lpszUrl が NULL 以外の場合、ホスト値はそこから抽出され、その特定のホストに ping を実行するために使用されます。
- lpszUrl が NULL で、最も近いサーバーの内部サーバー データベースにエントリがある場合、ホスト値はエントリから抽出され、そのサーバーの ping に使用されます。
[in] dwReserved
このパラメーターは予約されており、0 である必要があります。
戻り値
接続が正常に行われた場合は TRUE 、それ以外の場合は FALSE を 返します。 GetLastError を使用してエラー コードを取得します。 接続できない場合、またはソケット データベースが無条件にオフラインの場合、 getLastError によってERROR_NOT_CONNECTEDが返されます。
解説
InternetCheckConnection は非推奨です。 InternetCheckConnection は、Web プロキシ サーバーを使用してインターネットにアクセスする環境では機能しません。 環境に応じて、代わりに NetworkInformation.GetInternetConnectionProfile または NLM インターフェイスを使用してインターネット アクセスをチェックします。
注意
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetCheckConnection を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |