InternetGetConnectedState 関数 (wininet.h)
構文
BOOL InternetGetConnectedState(
[out] LPDWORD lpdwFlags,
[in] DWORD dwReserved
);
パラメーター
[out] lpdwFlags
接続の説明を受け取る変数へのポインター。 このパラメーターは、関数が FALSE を返す場合でも、有効なフラグを返す場合があります。 このパラメーターには、次の 1 つ以上の値を指定できます。
[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 またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h (Wininet.h を含む) |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |