DevicePolicyManager.SetAlwaysOnVpnPackage Metodo

Definizione

Spazio dei nomi:: Android.App.Admin

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Nome	Descrizione
SetAlwaysOnVpnPackage(ComponentName, String, Boolean)	Chiamato da un proprietario di un dispositivo o di un profilo per configurare una connessione VPN always-on tramite un'applicazione specifica per l'utente corrente.
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)	Versione di che consente all'amministratore di `#setAlwaysOnVpnPackage(ComponentName, String, boolean)` specificare un set di app che devono essere in grado di accedere alla rete direttamente quando la VPN non è connessa.

SetAlwaysOnVpnPackage(ComponentName, String, Boolean)

Chiamato da un proprietario di un dispositivo o di un profilo per configurare una connessione VPN always-on tramite un'applicazione specifica per l'utente corrente.

[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

Parametri

admin: ComponentName

vpnPackage: String

Nome del pacchetto per un'app VPN installata nel dispositivo o null per rimuovere una configurazione VPN always-on esistente.

lockdownEnabled: Boolean

true per impedire la rete quando la VPN non è connessa o false in altro modo. Questo non ha alcun effetto durante la cancellazione.

Attributi: RegisterAttribute

Commenti

Chiamato da un proprietario di un dispositivo o di un profilo per configurare una connessione VPN always-on tramite un'applicazione specifica per l'utente corrente. Questa connessione viene concessa e salvata automaticamente in modo permanente dopo un riavvio.

Per supportare la funzionalità sempre attiva, un'app deve <><>dichiarare un oggetto android.net.VpnService nel manifesto, sorvegliato da ;<android.Manifest.permission#BIND_VPN_SERVICE/li target>android.os.Build.VERSION_CODES#N API 24 o versione successiva; e</li><li>><non rifiutare esplicitamente la funzionalità tramite android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON.</li></ul> La chiamata avrà esito negativo se viene chiamato con il nome del pacchetto di un'app VPN non supportata.

L'abilitazione del blocco tramite lockdownEnabled argomento comporta il rischio che qualsiasi errore del provider VPN potrebbe interrompere la rete per tutte le app. Questo metodo cancella tutti gli elenchi consentiti di blocco impostati da #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set).

A partire dalla android.os.Build.VERSION_CODES#S API 31 chiamata a questo metodo con vpnPackage impostato su null rimuove solo la configurazione esistente se è stata creata in precedenza dall'amministratore. Per rimuovere la configurazione VPN creata dall'utente, usare UserManager#DISALLOW_CONFIG_VPN.

per android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

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

[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

Parametri

admin: ComponentName

vpnPackage: String

nome del pacchetto per un'app VPN installata nel dispositivo o null per rimuovere una configurazione VPN always-on esistente

lockdownEnabled: Boolean

true per impedire la rete quando la VPN non è connessa o false in altro modo. Questo non ha alcun effetto durante la cancellazione.

lockdownAllowlist: ICollection<String>

Pacchetti che potranno accedere alla rete direttamente quando la VPN è in modalità di blocco ma non è connessa. Non ha alcun effetto durante la cancellazione.

Attributi: RegisterAttribute

Commenti

Versione di che consente all'amministratore di #setAlwaysOnVpnPackage(ComponentName, String, boolean) specificare un set di app che devono essere in grado di accedere alla rete direttamente quando la VPN non è connessa. Quando la VPN connette queste app passa alla VPN, se è consentita l'uso di tale VPN. Le app di sistema possono sempre ignorare la VPN.

Si noti che il sistema non aggiorna l'elenco di elementi consentiti quando i pacchetti vengono installati o disinstallati, l'app amministratore deve chiamare questo metodo per mantenere aggiornato l'elenco.

Quando lockdownEnabled è false lockdownAllowlist viene ignorato . Quando lockdownEnabled è e lockdownAllowlist è nulltrue o vuoto, solo le app di sistema possono ignorare la VPN.

L'impostazione del pacchetto VPN always-on su null o l'uso #setAlwaysOnVpnPackage(ComponentName, String, boolean) di cancella l'elenco di elementi consentiti per il blocco.

per android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean, java.util.Set<java.lang.String>).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a