InternetGetConnectedStateExA 関数 (wininet.h)

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

構文

BOOL InternetGetConnectedStateExA(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   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) を使用します。
 

注意

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

要件

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

こちらもご覧ください

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

WinINet 関数