XNetworkingConnectivityHint
Définit l’état actuel du réseau à l’échelle de l’appareil, y compris le niveau de connectivité réseau, les limites de données, le type d’interface et l’état d’initialisation du réseau.Syntaxe
Membres
connectivityLevelType : XNetworkingConnectivityLevelHint Niveau de connectivité actuel de l’appareil, estimé au mieux. connectivityCost
Type : XNetworkingConnectivityCostHint Classification actuelle des limites de données de l’appareil, estimée au mieux. ianaInterfaceType
Type : uint32_t Type d’interface actuel susceptible d’être utilisé par WinSock et WinHTTP pour accéder à Internet. Il s’agit de l’un des types d’interfaces NDIS IANA. networkInitialized
Type : bool Détermine si le réseau est actuellement initialisé. Pour plus d’informations, consultez la section Initialisation du réseau de Récupération des informations réseau. approachingDataLimit
Type : bool Détermine si l’appareil est sur le point de dépasser ses limites de données. overDataLimit
Type : bool Détermine si l’appareil a dépassé ses limites de données. roaming
Type : bool Détermine si l’appareil est en itinérance ou non.
Remarques
Assurez-vous que le membre networkInitialized renvoie true avant d’essayer d’utiliser des API réseau ou de sécurité.Toute tentative d’utilisation des API XNetworking avec un réseau non initialisé entraînera des échecs d’appels et un comportement imprévisible.
XNetworkingConnectivityHint renvoyée (à l’exception du champ XNetworkingConnectivityHint::networkInitialized) sont des indications. Il s’agit d’estimations faites au mieux par l’appareil sur l’état actuel du réseau, à partir d’une synthèse du trafic réseau de l’appareil. Il est important de noter que ces champs n’indiquent pas s’il existe une connectivité vers les points de terminaison spécifiques de votre titre. Nous vous recommandons, après avoir attendu l’initialisation du réseau, d’utiliser WinSock et/ou WinHTTP pour tenter d’établir une connexion à votre point de terminaison, quel que soit l’état du champ XNetworkingConnectivityHint::connectivityLevelHint. Si ces API échouent ensuite, nous vous recommandons d’utiliser l’API XNetworkingGetConnectivityHint à des fins supplémentaires d’interface utilisateur et de rapports de diagnostic. Vous devez ensuite attendre une modification du niveau de connectivité réseau avant de réessayer.