Networking_GetInterfaceConnectionStatus függvény

Fejléc: #include <applibs/networking.h>

Lekéri egy hálózati adapter hálózati kapcsolati állapotát. A Networking_GetInterfaceConnectionStatus meghívásakor az operációs rendszer az utolsó ismert állapotot adja vissza, és megpróbálja frissíteni a megadott felületi állapotot a Networking_InterfaceConnectionStatus enumerálásban.

A Networking_InterfaceConnectionStatus visszaadott enumerálás az adapter, a hálózati kapcsolat, az IP-cím és az internetkapcsolat utolsó ismert állapotát tükrözi. A Networking_GetInterfaceConnectionStatus meghívásakor az operációs rendszer megpróbálja frissíteni ezeket az állapotjelzőket, és az Azure Sphere operációs rendszer hálózati követelményeiben leírtak szerint hívást http://www.msftconnecttest.com kezdeményez annak megállapításához, hogy az eszköz rendelkezik-e internetkapcsolattal.

Egy alkalmazás a Networking_InterfaceConnectionStatus_ConnectedToInternet állapota alapján műveletet hajthat végre, ami azt jelzi, hogy az eszköz csatlakozik-e az internethez. Különböző okokból azonban megszakadhat a hálózati vagy internetkapcsolat az állapot frissítése és az alkalmazás internetkapcsolatának megkísérlése között. Ezért az alkalmazásnak olyan logikát kell tartalmaznia, amely intelligens választásokat tesz lehetővé a hálózat és az internet rendelkezésre állásának változásai esetén. Az alkalmazásnak kezelnie kell a csatlakozási hibákat, és ennek megfelelően kell alkalmazkodnia.

Ha a visszaadott állapot azt jelzi, hogy az eszköz nem csatlakozik az internethez, az alkalmazás újra meghívhatja Networking_GetInterfaceConnectionStatus , hogy megállapítsa, mikor változik az eszköz állapota.

Ha Networking_InterfaceConnectionStatus_ConnectedToInternet azt jelzi, hogy az eszköz csatlakozik az internethez, az eszköznek nem szabad 90 másodpercenként többször lekérdeznie az állapotot. Ha ez a kapcsolati állapotfüggvény ismételten azt jelzi, hogy az eszköz csatlakozik az internethez, az operációs rendszer szabályozza az állapotellenőrzést, ha a lekérdezési időköz túl rövid. A javasolt alkalmazás-lekérdezési időköz egy kérés/két perc.

int Networking_GetInterfaceConnectionStatus(const char *networkInterfaceName, Networking_InterfaceConnectionStatus *outStatus);

Paraméterek

• networkInterfaceName A hálózati adapter neve.

• outStatus A hálózati kapcsolat állapotát fogadó Networking_InterfaceConnectionStatus enumerálásra mutató mutató.

Hibák

-1 értéket ad vissza, ha hiba történik, és a hibaértékre van halmazva errno .

• EFAULT: a outStatus paraméter NULL.

• ENOENT: az networkInterfaceName interfész nem létezik.

• EAGAIN: a hálózati verem nem áll készen.

errno Más is megadható; az ilyen hibák nem determinisztikusak, és előfordulhat, hogy a rendszerfrissítések nem őrzik meg ugyanazt a viselkedést.

Visszatérési érték

0 értéket ad vissza a sikerhez, -1 hibát, amely esetben errno a hibaérték van beállítva.

Fogalmak és minták

• Minta: Privát hálózati szolgáltatások