IsNetworkAlive 関数 (sensapi.h)
IsNetworkAlive 関数は、ローカル システムがネットワークに接続されているかどうかを判断し、ネットワーク接続の種類 (LAN、WAN、またはその両方など) を識別します。
構文
BOOL IsNetworkAlive(
[out] LPDWORD lpdwFlags
);
パラメーター
[out] lpdwFlags
使用可能なネットワーク接続の種類。 このパラメーターには、次のいずれかの値を指定できます。
NETWORK_ALIVE_LAN
コンピューターには、アクティブな 1 つ以上の LAN カードがあります。
NETWORK_ALIVE_WAN
コンピューターに 1 つ以上のアクティブな RAS 接続があります。
戻り値
この関数のリターン コードを確認する前に、必ず GetLastError を呼び出してください。 最後のエラーが 0 でない場合、 IsNetworkAlive 関数は失敗し、次の TRUE と FALSE の 値は適用されません。
| リターン コード | 説明 |
|---|---|
|
最後のエラーが 0 で、関数が TRUE を返した場合、SENS はローカル システムがネットワークに接続されていることを確認しました。
接続の種類については、 lpdwFlags パラメーターを参照してください。 |
|
最後のエラーが 0 で、関数が FALSE を返した場合、SENS は接続がないと判断しました。 |
注釈
Windows Vista および Windows Server 2008 用に設計されたアプリケーション以降、開発者はこの関数ではなく ネットワーク リスト マネージャー の使用を検討する必要があります。
この関数は、ネットワーク操作を続行する前に、アプリケーションでネットワーク接続があるかどうかを判断するために使用できます。 アプリケーション、電子メール クライアント、またはインターネット ブラウザーのディレクトリ サービスの種類は、さまざまな種類のネットワーク接続に適応できます。 たとえば、ネットワーク接続が使用可能になるまで、印刷操作を遅延させることができます。
IsNetworkAlive が遅くなる可能性があり、関数がローカル システムが切断されていることを検出するのに時間がかかりすぎる可能性があるため、アプリケーションが IsNetworkAlive を呼び出してローカル システムが LAN から切断されているかどうかを判断することは、必ずしも実用的でない場合があります。 ただし、 IsNetworkAlive では、現時点では常に WAN 接続を識別できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | sensapi.h |
| Library | Sensapi.lib |
| [DLL] | Sensapi.dll |