IsNetworkAlive-Funktion (sensapi.h)

Die IsNetworkAlive-Funktion bestimmt, ob ein lokales System mit einem Netzwerk verbunden ist, und identifiziert den Typ der Netzwerkverbindung, z. B. lan, WAN oder beides.

Syntax

BOOL IsNetworkAlive(
  [out] LPDWORD lpdwFlags
);

Parameter

[out] lpdwFlags

Der Typ der verfügbaren Netzwerkverbindung. Dieser Parameter kann einer der folgenden Werte sein:

NETWORK_ALIVE_LAN

Der Computer verfügt über eine oder mehrere LAN-Karten, die aktiv sind.

NETWORK_ALIVE_WAN

Der Computer verfügt über eine oder mehrere aktive RAS-Verbindungen.

Rückgabewert

Rufen Sie immer GetLastError auf, bevor Sie den Rückgabecode dieser Funktion überprüfen. Wenn der letzte Fehler nicht 0 ist, ist die IsNetworkAlive-Funktion fehlgeschlagen, und die folgenden WERTE TRUE und FALSE werden nicht angewendet.

Rückgabecode	Beschreibung
TRUE	Wenn der letzte Fehler 0 ist und die Funktion TRUE zurückgibt, hat SENS ermittelt, dass ein lokales System mit einem Netzwerk verbunden ist. Informationen zum Verbindungstyp finden Sie im lpdwFlags-Parameter .
FALSE	Wenn der letzte Fehler 0 ist und die Funktion FALSE zurückgibt, hat SENS festgestellt, dass keine Verbindung besteht.

Hinweise

Beginnend mit Anwendungen, die für Windows Vista und Windows Server 2008 entwickelt wurden, sollten Entwickler die Verwendung des Netzwerklisten-Managers anstelle dieser Funktion in Betracht ziehen.

Diese Funktion kann von einer Anwendung verwendet werden, um zu bestimmen, ob eine Netzwerkkonnektivität besteht oder nicht, bevor Sie mit Netzwerkvorgängen fortfahren. Ein Verzeichnisdiensttyp von Anwendung, E-Mail-Client oder Internetbrowser kann sich an verschiedene Arten von Netzwerkkonnektivität anpassen. Beispielsweise kann ein Druckvorgang verzögert werden, bis eine Netzwerkverbindung verfügbar ist.

Es ist möglicherweise nicht immer praktisch, dass eine Anwendung IsNetworkAlive aufruft, um zu bestimmen, ob ein lokales System von einem LAN getrennt ist, da IsNetworkAlive langsam sein kann und es zu viel Zeit dauern kann, bis die Funktion erkennt, dass ein lokales System getrennt ist. IsNetworkAlive kann jedoch im Moment immer eine WAN-Konnektivität identifizieren.

Hinweis Diese Funktion ist nur für TCP/IP-Verbindungen verfügbar.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sensapi.h
Bibliothek	Sensapi.lib
DLL	Sensapi.dll

Weitere Informationen

Informationen zum Systemereignisbenachrichtigungsdienst

IsDestinationReachable