DevicePolicyManager.SetAlwaysOnVpnPackage Methode

Definition

Namespace:

Android.App.Admin

Assembly:

Mono.Android.dll

Überlädt

SetAlwaysOnVpnPackage(ComponentName, String, Boolean)	Wird von einem Gerät oder Profilbesitzer aufgerufen, um eine Always-On-VPN-Verbindung über eine bestimmte Anwendung für den aktuellen Benutzer zu konfigurieren.
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)	Eine Version davon #setAlwaysOnVpnPackage(ComponentName, String, boolean) ermöglicht es dem Administrator, eine Reihe von Apps anzugeben, die direkt auf das Netzwerk zugreifen können sollen, wenn VPN nicht verbunden ist.

SetAlwaysOnVpnPackage(ComponentName, String, Boolean)

Wird von einem Gerät oder Profilbesitzer aufgerufen, um eine Always-On-VPN-Verbindung über eine bestimmte Anwendung für den aktuellen Benutzer zu konfigurieren.

[Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;Z)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZHandler", ApiSince=24)]
public virtual void SetAlwaysOnVpnPackage (Android.Content.ComponentName admin, string? vpnPackage, bool lockdownEnabled);

[<Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;Z)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZHandler", ApiSince=24)>]
abstract member SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool -> unit
override this.SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool -> unit

Parameter

admin

ComponentName

vpnPackage

String

Der Paketname für eine installierte VPN-App auf dem Gerät oder null zum Entfernen einer vorhandenen Always-On-VPN-Konfiguration.

lockdownEnabled

Boolean

true Netzwerk zu verbieten, wenn das VPN nicht verbunden ist oder false anderweitig. Dies hat keine Auswirkung beim Löschen.

Attribute

RegisterAttribute

Hinweise

Wird von einem Gerät oder Profilbesitzer aufgerufen, um eine Always-On-VPN-Verbindung über eine bestimmte Anwendung für den aktuellen Benutzer zu konfigurieren. Diese Verbindung wird automatisch gewährt und nach einem Neustart beibehalten.

Um das Always-On-Feature zu unterstützen, muss <><>eine App ein android.net.VpnService in seinem Manifest deklarieren, geschützt von ;<android.Manifest.permission#BIND_VPN_SERVICE/li li><>target android.os.Build.VERSION_CODES#N API 24 or above; and</li li not<>> explizit opt out of the feature through .<android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON/li></ul> Der Aufruf schlägt fehl, wenn der Paketname einer nicht unterstützten VPN-App aufgerufen wird.

Das Aktivieren der Sperrung über lockdownEnabled Argument birgt das Risiko, dass ein Fehler des VPN-Anbieters das Netzwerk für alle Apps unterbrechen könnte. Mit dieser Methode werden alle Sperrmodus-Zulassungslisten gelöscht, die von #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set).

Ab dem android.os.Build.VERSION_CODES#S API 31 Aufrufen dieser Methode mit vpnPackage "Set" wird null nur die vorhandene Konfiguration entfernt, wenn sie zuvor von diesem Administrator erstellt wurde. So entfernen Sie die vpn-Konfiguration, die vom Benutzer UserManager#DISALLOW_CONFIG_VPNerstellt wurde.

Java-Dokumentation für android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)

Eine Version davon #setAlwaysOnVpnPackage(ComponentName, String, boolean) ermöglicht es dem Administrator, eine Reihe von Apps anzugeben, die direkt auf das Netzwerk zugreifen können sollen, wenn VPN nicht verbunden ist.

[Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;ZLjava/util/Set;)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZLjava_util_Set_Handler", ApiSince=29)]
public virtual void SetAlwaysOnVpnPackage (Android.Content.ComponentName admin, string? vpnPackage, bool lockdownEnabled, System.Collections.Generic.ICollection<string>? lockdownAllowlist);

[<Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;ZLjava/util/Set;)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZLjava_util_Set_Handler", ApiSince=29)>]
abstract member SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool * System.Collections.Generic.ICollection<string> -> unit
override this.SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool * System.Collections.Generic.ICollection<string> -> unit

Parameter

admin

ComponentName

vpnPackage

String

Paketname für eine installierte VPN-App auf dem Gerät oder null zum Entfernen einer vorhandenen Always-On-VPN-Konfiguration

lockdownEnabled

Boolean

true Netzwerk zu verbieten, wenn das VPN nicht verbunden ist oder false anderweitig. Dies hat keine Auswirkung beim Löschen.

lockdownAllowlist

ICollection<String>

Pakete, die direkt auf das Netzwerk zugreifen können, wenn SICH VPN im Sperrmodus befindet, aber nicht verbunden ist. Hat keine Auswirkung beim Löschen.

Attribute

RegisterAttribute

Hinweise

Eine Version davon #setAlwaysOnVpnPackage(ComponentName, String, boolean) ermöglicht es dem Administrator, eine Reihe von Apps anzugeben, die direkt auf das Netzwerk zugreifen können sollen, wenn VPN nicht verbunden ist. Wenn VPN eine Verbindung zwischen diesen Apps herstellt, wechseln Sie zu VPN, wenn sie dieses VPN verwenden dürfen. System-Apps können VPN jederzeit umgehen.

Beachten Sie, dass das System die Zulassungsliste nicht aktualisiert, wenn Pakete installiert oder deinstalliert werden, muss die Administrator-App diese Methode aufrufen, um die Liste auf dem neuesten Stand zu halten.

Wenn lockdownEnabled falsch lockdownAllowlist ist, wird ignoriert. true Ist lockdownEnabled und ist null oder lockdownAllowlist leer, können nur System-Apps VPN umgehen.

Festlegen des Always-On-VPN-Pakets auf null oder Verwenden der #setAlwaysOnVpnPackage(ComponentName, String, boolean) Sperrmodus-Zulassungsliste.

Java-Dokumentation für android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean, java.util.Set<java.lang.String>).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.