InternetGetConnectedStateEx 関数 (winineti.h)

構文

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [in]  DWORD   dwReserved
);

パラメーター

[out] lpdwFlags

接続の説明を受け取る変数へのポインター。 このパラメーターは、関数が FALSE を返した場合でも、有効なフラグを返す場合があります。 このパラメーターは、次の値と組み合わせて使用できます。

[out] lpszConnectionName

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

[in] dwNameLen

TCHAR の lpszConnectionName 文字列のサイズ。

[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 関数