InternetGetConnectedState 関数 (wininet.h)

  • [アーティクル]
メモ この API の使用は推奨されません。代わりに INetworkListManager::GetConnectivity メソッドを使用してください。
 
ローカル システムの接続状態を取得します。

構文

BOOL InternetGetConnectedState(
  [out] LPDWORD lpdwFlags,
  [in]  DWORD   dwReserved
);

パラメーター

[out] lpdwFlags

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

値 意味
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
 ローカル システムでは、プロキシ サーバーを使用してインターネットに接続します。
INTERNET_RAS_INSTALLED
0x10
 ローカル システムには RAS がインストールされています。

[in] dwReserved

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

戻り値

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

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

注釈

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

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

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

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

要件

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

こちらもご覧ください

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

WinINet 関数