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 |
|---|---|
|
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 . |
|
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.
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 |