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は、現在使用できる唯一のフラグです。 このフラグを設定すると、強制的に接続されます。 ソケット接続は次の順序で試行されます。

  • lpszUrlNULL 以外の場合、ホスト値はそこから抽出され、その特定のホストに ping を実行するために使用されます。
  • lpszUrlNULL で、最も近いサーバーの内部サーバー データベースにエントリがある場合、ホスト値はエントリから抽出され、そのサーバーの ping に使用されます。

[in] dwReserved

このパラメーターは予約されており、0 である必要があります。

戻り値

接続が正常に行われた場合は TRUE 、それ以外の場合は FALSE を 返します。 GetLastError を使用してエラー コードを取得します。 接続できない場合、またはソケット データベースが無条件にオフラインの場合、 getLastError によってERROR_NOT_CONNECTEDが返されます。

解説

InternetCheckConnection は非推奨です。 InternetCheckConnection は、Web プロキシ サーバーを使用してインターネットにアクセスする環境では機能しません。 環境に応じて、代わりに NetworkInformation.GetInternetConnectionProfile または NLM インターフェイスを使用してインターネット アクセスをチェックします。

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

注意

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

要件

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

関連項目

インターネット機能の有効化

WinINet 関数