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 Le niveau de connectivité actuel de l’appareil, déterminé au mieux. connectivityCost
Type : XNetworkingConnectivityCostHint La classification actuelle des limites de données de l’appareil, déterminée au mieux. ianaInterfaceType
Type : uint32_t Le type d’interface actuel susceptible d’être utilisé par WinSock et WinHTTP pour atteindre Internet. L’un des types d’interface NDIS de l’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 retourne true avant de tenter d’utiliser des API de réseau ou de sécurité.Tenter d’utiliser les API XNetworking avec un réseau qui n’est pas initialisé entraînera des échecs d’appels et un comportement imprévisible.
XNetworkingConnectivityHint retournée (à l’exception du champ XNetworkingConnectivityHint::networkInitialized) sont des indications. Il s’agit d’estimations faites au mieux par l’appareil quant à l’état actuel du réseau, à partir d’un résumé du trafic réseau sur l’appareil. Il est important de noter que ces champs n’indiquent pas s’il existe une connectivité vers les points de terminaison propres à votre titre. Nous vous recommandons, après avoir attendu l’initialisation du réseau, d’utiliser WinSock ou WinHTTP (ou les deux) pour tenter d’établir une connexion à votre point de terminaison, quel que soit l’état du champ XNetworkingConnectivityHint::connectivityLevelHint. Si ces API échouent par la suite, nous vous recommandons d’utiliser alors l’API XNetworkingGetConnectivityHint à des fins supplémentaires d’interface utilisateur et de rapports de diagnostic. Vous devez ensuite attendre un changement du niveau de connectivité réseau avant de réessayer.