DevicePolicyManager.SetAlwaysOnVpnPackage 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>) |
其中一個版本 |
| SetAlwaysOnVpnPackage(ComponentName, String, Boolean) |
由裝置或設定檔擁有者呼叫，透過特定應用程式為目前使用者設定全天候連線的 VPN 連線。 |
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)
其中一個版本 #setAlwaysOnVpnPackage(ComponentName, String, boolean) 允許管理員指定一組應用程式，當沒有連接 VPN 時，這些應用程式應該能直接存取網路。
[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參數
- admin
- ComponentName
- vpnPackage
- String
裝置上安裝的 VPN 應用程式的套件名稱，或 null 移除現有的 VPN 常開設定
- lockdownEnabled
- Boolean
true 當 VPN 未連接或其他 false 情況下，禁止網路連線。 這在清場時沒有效果。
- lockdownAllowlist
- ICollection<String>
這些套件能在 VPN 鎖定模式但未連接時直接存取網路。 清場時沒有效果。
- 屬性
備註
其中一個版本 #setAlwaysOnVpnPackage(ComponentName, String, boolean) 允許管理員指定一組應用程式，當沒有連接 VPN 時，這些應用程式應該能直接存取網路。 當 VPN 連接時，這些應用程式如果被允許使用 VPN，就會切換到 VPN。 系統應用程式總是可以繞過 VPN。
請注意，系統在安裝或卸載套件時不會更新允許清單，管理員應用程式必須呼叫此方法來保持清單的更新。
當 lockdownEnabled 為假 lockdownAllowlist 時，忽略 。 當 lockdownEnabled 和 truelockdownAllowlist 是 null 或為空時，只有系統應用程式能繞過 VPN。
將 Always on VPN 套件設定為 null 或使用 #setAlwaysOnVpnPackage(ComponentName, String, boolean) Clearlock Allowlist 即可清除。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
SetAlwaysOnVpnPackage(ComponentName, String, Boolean)
由裝置或設定檔擁有者呼叫，透過特定應用程式為目前使用者設定全天候連線的 VPN 連線。
[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參數
- admin
- ComponentName
- vpnPackage
- String
這是裝置上安裝的 VPN 應用程式的套件名稱，或 null 是移除現有的 VPN 常設設定。
- lockdownEnabled
- Boolean
true 當 VPN 未連接或其他 false 情況下，禁止網路連線。 這在清場時沒有效果。
- 屬性
備註
由裝置或設定檔擁有者呼叫，透過特定應用程式為目前使用者設定全天候連線的 VPN 連線。 此連線在重啟後會自動被授予並持續存在。
為了支援 Always on 功能，應用程式必須<在其 manifest 中宣告 a><>android.net.VpnService，並由 ;android.Manifest.permission#BIND_VPN_SERVICE</li><li >android.os.Build.VERSION_CODES#N API 24目標或以上;且</li><li>並未明確選擇退出該功能。android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON</li></ul> 如果用不支援的 VPN 應用程式的套件名稱呼叫，通話將會失敗。
透過 lockdownEnabled 參數啟用鎖定存在 VPN 服務提供者任何故障都可能破壞所有應用程式的網路安全的風險。 此方法可清除由 設定 #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set)的任何鎖定允許清單。
從 android.os.Build.VERSION_CODES#S API 31 呼叫這個方法開始，設定 vpnPackage 為 ， null 只會移除先前由該管理員建立的現有設定。若要移除使用者所建立的 VPN 設定，請使用 UserManager#DISALLOW_CONFIG_VPN。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。