次の方法で共有


InternetGetConnectedStateExW 関数 (winineti.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

TBD

[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) を使用します。
 

注意

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

要件

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

こちらもご覧ください

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

WinINet 関数