InternetGetConnectedStateEx 関数 (winineti.h)

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

構文

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [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

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

[in] dwNameLen

TCHARlpszConnectionName 文字列のサイズ。

[in] dwReserved

このパラメーターは予約済みであり、 NULL である必要があります。

戻り値

インターネット接続がある場合は 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
ヘッダー winineti.h (Wininet.h、Winineti.h、Wininet.h、Winineti.h を含む)
Library Wininet.lib
[DLL] Wininet.dll

関連項目

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

WinINet 関数