DevicePolicyManager.SetAlwaysOnVpnPackage Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| SetAlwaysOnVpnPackage(ComponentName, String, Boolean) |
Chamado por um proprietário de dispositivo ou perfil para configurar uma conexão VPN sempre ativa por meio de um aplicativo específico para o usuário atual. |
| SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>) |
Uma versão disso |
SetAlwaysOnVpnPackage(ComponentName, String, Boolean)
Chamado por um proprietário de dispositivo ou perfil para configurar uma conexão VPN sempre ativa por meio de um aplicativo específico para o usuário atual.
[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
Parâmetros
- admin
- ComponentName
- vpnPackage
- String
O nome do pacote para um aplicativo VPN instalado no dispositivo ou null para remover uma configuração de VPN sempre ativa existente.
- lockdownEnabled
- Boolean
true para não permitir a rede quando a VPN não estiver conectada ou false não. Isso não tem efeito ao limpar.
- Atributos
Comentários
Chamado por um proprietário de dispositivo ou perfil para configurar uma conexão VPN sempre ativa por meio de um aplicativo específico para o usuário atual. Essa conexão é concedida e persistida automaticamente após uma reinicialização.
Para dar suporte ao recurso sempre ativo, um aplicativo deve <><>declarar um android.net.VpnService em seu manifesto, protegido por ;android.Manifest.permission#BIND_VPN_SERVICE</li>li ou superior; e</li>android.os.Build.VERSION_CODES#N API 24li> desativar explicitamente o recurso por meio <de .>android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON</li></ul> A chamada falhará se for chamada com o nome do pacote de um aplicativo VPN sem suporte.
Habilitar o bloqueio por meio lockdownEnabled do argumento traz o risco de que qualquer falha do provedor de VPN possa interromper a rede para todos os aplicativos. Esse método limpa qualquer lista de permissões de bloqueio definida pelo #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set).
Começar chamando android.os.Build.VERSION_CODES#S API 31 esse método com vpnPackage set to null remove apenas a configuração existente se ela tiver sido criada anteriormente por este administrador. Para remover a configuração de VPN criada pelo usuário, use UserManager#DISALLOW_CONFIG_VPN.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.
Aplica-se a
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)
Uma versão disso #setAlwaysOnVpnPackage(ComponentName, String, boolean) permite que o administrador especifique um conjunto de aplicativos que devem ser capazes de acessar a rede diretamente quando a VPN não estiver conectada.
[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
Parâmetros
- admin
- ComponentName
- vpnPackage
- String
nome do pacote para um aplicativo VPN instalado no dispositivo ou null para remover uma configuração de VPN sempre ativa existente
- lockdownEnabled
- Boolean
true para não permitir a rede quando a VPN não estiver conectada ou false não. Isso não tem efeito ao limpar.
- lockdownAllowlist
- ICollection<String>
Pacotes que poderão acessar a rede diretamente quando a VPN estiver no modo de bloqueio, mas não conectada. Não tem efeito ao limpar.
- Atributos
Comentários
Uma versão disso #setAlwaysOnVpnPackage(ComponentName, String, boolean) permite que o administrador especifique um conjunto de aplicativos que devem ser capazes de acessar a rede diretamente quando a VPN não estiver conectada. Quando a VPN se conecta, esses aplicativos mudam para VPN se tiverem permissão para usar essa VPN. Os aplicativos do sistema sempre podem ignorar a VPN.
Observe que o sistema não atualiza a lista de permissões quando os pacotes são instalados ou desinstalados, o aplicativo de administração deve chamar esse método para manter a lista atualizada.
Quando lockdownEnabled é falso lockdownAllowlist é ignorado . Quando lockdownEnabled é true e lockdownAllowlist é null ou vazio, apenas os aplicativos do sistema podem ignorar a VPN.
Definir o pacote VPN sempre ativo como null ou usar #setAlwaysOnVpnPackage(ComponentName, String, boolean) limpa a lista de permissões de bloqueio.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.