InternetGetConnectedStateExA 関数 (winineti.h)
構文
BOOL InternetGetConnectedStateExA(
[out] LPDWORD lpdwFlags,
[out] LPSTR lpszConnectionName,
DWORD cchNameLen,
[in] DWORD dwReserved
);
パラメーター
[out] lpdwFlags
接続の説明を受け取る変数へのポインター。 このパラメーターは、関数が FALSE を返す場合でも、有効なフラグを返す場合があります。 このパラメーターは、次の値と組み合わせて使用できます。
[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 またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
注意
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 |