次の方法で共有

InternetGetConnectedStateExW 関数 (wininet.h)

  • [アーティクル]
この API の使用はお勧めしません、代わりに INetworkListManager::GetConnectivity メソッドを使用してください。
 
指定したインターネット接続の接続状態を取得します。

構文

BOOL InternetGetConnectedStateExW(
  [out] LPDWORD lpdwFlags,
  [out] LPWSTR  lpszConnectionName,
        DWORD   cchNameLen,
  [in]  DWORD   dwReserved
);

パラメーター

[out] lpdwFlags

接続の説明を受け取る変数へのポインター。 このパラメーターは、関数が FALSE返した場合でも、有効なフラグを返す場合があります。 このパラメーターには、次の値の組み合わせを指定できます。

価値 意味
INTERNET_CONNECTION_CONFIGURED
0x40
 ローカル システムはインターネットに有効な接続を持っていますが、現在接続されている場合と接続されていない可能性があります。
INTERNET_CONNECTION_LAN
0x02
 ローカル システムは、ローカル エリア ネットワークを使用してインターネットに接続します。
INTERNET_CONNECTION_MODEM
0x01
 ローカル システムでは、モデムを使用してインターネットに接続します。
INTERNET_CONNECTION_MODEM_BUSY
0x08
 使用されなくなりました。
INTERNET_CONNECTION_OFFLINE
0x20
 ローカル システムはオフライン モードです。
INTERNET_CONNECTION_PROXY
0x04
 ローカル システムでは、プロキシ サーバーを使用してインターネットに接続します。

[out] lpszConnectionName

接続名を受け取る文字列値へのポインター。

cchNameLen

未定

[in] dwReserved

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

戻り値

インターネット接続がある場合 TRUE を返します。インターネット接続がない場合、または使用可能なすべてのインターネット接続が現在アクティブでない場合は FALSE を します。 詳細については、「解説」セクションを参照してください。

InternetGetConnectedState が FALSE返すと、アプリケーションは GetLastError 呼び出してエラー コードを取得できます。

備考

InternetGetConnectedState からの TRUE 戻り値は、インターネットへの接続が少なくとも 1 つ使用可能であることを示します。 特定のホストへの接続を確立できることを保証するものではありません。 アプリケーションは、サーバーに接続する API 呼び出しから返されるエラーを常にチェックする必要があります。 InternetCheckConnection を呼び出して、特定の宛先への接続を確立できるかどうかを判断できます。

戻り値 TRUE は、モデム接続がアクティブであるか、LAN 接続がアクティブであり、プロキシが LAN 用に適切に構成されていることを示します。 FALSE の戻り値は、モデムと LAN の両方が接続されていないことを示します。 FALSE が返された場合、自動ダイヤルが "常にダイヤル" するように構成されているが、現在アクティブでないことを示す INTERNET_CONNECTION_CONFIGURED フラグが設定される場合があります。 自動ダイヤルが構成されていない場合、関数は FALSE返します。

WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。

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

手記

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

必要条件

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

関連項目

インターネット へのダイヤルアップ接続を確立する

WinINet Functions の