次の方法で共有

InternetCheckConnectionA 関数 (wininet.h)

  • [アーティクル]

[InternetCheckConnection は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 代わりに、NetworkInformation.GetInternetConnectionProfile または NLM インターフェイスを使用します。 ]

アプリケーションがインターネットへの接続を確立できるかどうかを確認できるようにします。

構文

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

パラメーター

[in] lpszUrl

接続の確認に使用する URL を指定する、null-terminated 文字列へのポインター。 この値は 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 では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、Microsoft Windows HTTP Services (WinHTTP)を使用します。
 

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

インターネット機能 を有効にする

WinINet Functions の