VpnService.SetUnderlyingNetworks(Network[]) Méthode

[Android.Runtime.Register("setUnderlyingNetworks", "([Landroid/net/Network;)Z", "GetSetUnderlyingNetworks_arrayLandroid_net_Network_Handler", ApiSince=22)]
public virtual bool SetUnderlyingNetworks(Android.Net.Network[]? networks);

[<Android.Runtime.Register("setUnderlyingNetworks", "([Landroid/net/Network;)Z", "GetSetUnderlyingNetworks_arrayLandroid_net_Network_Handler", ApiSince=22)>]
abstract member SetUnderlyingNetworks : Android.Net.Network[] -> bool
override this.SetUnderlyingNetworks : Android.Net.Network[] -> bool

Paramètres

Retours

true sur le succès.

Attributs

RegisterAttribute

Remarques

Définit les réseaux sous-jacents utilisés par le VPN pour ses connexions en amont.

Utilisé par le système pour connaître les réseaux réels qui transportent le trafic pour les applications affectées par ce VPN afin de présenter ces informations à l’utilisateur (par exemple, via des icônes de barre d’état).

Cette méthode doit uniquement être appelée si le VPN a explicitement lié ses canaux de communication sous-jacents &mdash ; tels que le ou les sockets passés à #protect(int) &mdash ; à une Network API d’utilisation telles que Network#bindSocket(Socket) ou Network#bindSocket(DatagramSocket). Le VPN doit appeler cette méthode chaque fois que l’ensemble de Networks qu’il utilise des modifications.

networksest l’un des éléments suivants : ul<li strong un tableau> non vide/fort< : tableau d’un ou ><plusieurs s, dans l’ordre décroissant des préférences.><>Network Par exemple, si ce VPN utilise des réseaux wi-fi et mobile (cellulaires) pour transporter le trafic d’application, mais préfère ou utilise le wifi plus que le mobile, le wifi doit apparaître en premier dans le tableau.</li li><><strong>an empty array/strong< : a zero-element array>, signifie que le VPN n’a pas de connexion réseau sous-jacente, et par conséquent, le trafic d’application ne sera pas envoyé ou reçu.</li li><><strong>null</strong> : (valeur par défaut) signifie que le VPN utilise tout ce qui est le réseau par défaut du système. C’est-à-dire qu’il n’utilise pas les API mentionnées ci-dessus pour envoyer le bindSocketbindDatagramSocket trafic sur des canaux spécifiques.</li></ul>

Cet appel réussit uniquement si le VPN est actuellement établi. Pour définir cette valeur lorsque le VPN n’a pas encore été établi, consultez Builder#setUnderlyingNetworks.

Java documentation pour android.net.VpnService.setUnderlyingNetworks(android.net.Network[]).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.