IsNetworkAlive 関数 (sensapi.h)

[アーティクル]
08/26/2023

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 の 値は適用されません。

リターンコード	説明
TRUE	最後のエラーが 0 で、関数が TRUE を返した場合、SENS はローカルシステムがネットワークに接続されていることを確認しました。接続の種類については、 lpdwFlags パラメーターを参照してください。
FALSE	最後のエラーが 0 で、関数が FALSE を返した場合、SENS は接続がないと判断しました。

注釈

Windows Vista および Windows Server 2008 用に設計されたアプリケーション以降、開発者はこの関数ではなくネットワークリストマネージャーの使用を検討する必要があります。

この関数は、ネットワーク操作を続行する前に、アプリケーションでネットワーク接続があるかどうかを判断するために使用できます。アプリケーション、電子メールクライアント、またはインターネットブラウザーのディレクトリサービスの種類は、さまざまな種類のネットワーク接続に適応できます。たとえば、ネットワーク接続が使用可能になるまで、印刷操作を遅延させることができます。

IsNetworkAlive が遅くなる可能性があり、関数がローカルシステムが切断されていることを検出するのに時間がかかりすぎる可能性があるため、アプリケーションが IsNetworkAlive を呼び出してローカルシステムが LAN から切断されているかどうかを判断することは、必ずしも実用的でない場合があります。ただし、 IsNetworkAlive では、現時点では常に WAN 接続を識別できます。

メモこの関数は、TCP/IP 接続でのみ使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	sensapi.h
Library	Sensapi.lib
[DLL]	Sensapi.dll

こちらもご覧ください

システムイベント通知サービスについて

IsDestinationReachable

Share via