DevicePolicyManager.CreateAndManageUser 方法

定義

命名空間:: Android.App.Admin

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

由裝置擁有者呼叫，以建立擁有指定名稱及呼叫套件特定元件的使用者作為設定檔擁有者。

[Android.Runtime.Register("createAndManageUser", "(Landroid/content/ComponentName;Ljava/lang/String;Landroid/content/ComponentName;Landroid/os/PersistableBundle;I)Landroid/os/UserHandle;", "GetCreateAndManageUser_Landroid_content_ComponentName_Ljava_lang_String_Landroid_content_ComponentName_Landroid_os_PersistableBundle_IHandler", ApiSince=24)]
public virtual Android.OS.UserHandle? CreateAndManageUser(Android.Content.ComponentName admin, string name, Android.Content.ComponentName profileOwner, Android.OS.PersistableBundle? adminExtras, Android.App.Admin.UserManagementFlags flags);

[<Android.Runtime.Register("createAndManageUser", "(Landroid/content/ComponentName;Ljava/lang/String;Landroid/content/ComponentName;Landroid/os/PersistableBundle;I)Landroid/os/UserHandle;", "GetCreateAndManageUser_Landroid_content_ComponentName_Ljava_lang_String_Landroid_content_ComponentName_Landroid_os_PersistableBundle_IHandler", ApiSince=24)>]
abstract member CreateAndManageUser : Android.Content.ComponentName * string * Android.Content.ComponentName * Android.OS.PersistableBundle * Android.App.Admin.UserManagementFlags -> Android.OS.UserHandle
override this.CreateAndManageUser : Android.Content.ComponentName * string * Android.Content.ComponentName * Android.OS.PersistableBundle * Android.App.Admin.UserManagementFlags -> Android.OS.UserHandle

參數

admin: ComponentName

這個請求就是和這個 DeviceAdminReceiver 問題有關的。

name: String

使用者的名字。

profileOwner: ComponentName

他 DeviceAdminReceiver 會是個人資料擁有者。必須與管理員同一個套件，否則不會建立使用者並拋出 IllegalArgumentException。

adminExtras: PersistableBundle

這些額外資料會傳給新使用者的管理員接收器 onEnable。

flags: UserManagementFlags

#SKIP_SETUP_WIZARD， #MAKE_USER_EPHEMERAL#LEAVE_ALL_SYSTEM_APPS_ENABLED 且都被支援。

傳回

UserHandle

該物件用於 android.os.UserHandle 建立使用者，或 null 是該使用者無法被建立。

屬性: RegisterAttribute

備註

由裝置擁有者呼叫，以建立擁有指定名稱及呼叫套件特定元件的使用者作為設定檔擁有者。此方法回傳的 UserHandle 不應被持久化，因為使用者帳號會在移除與建立時被回收。如果你需要為此使用者持久化識別碼，請使用 UserManager#getSerialNumberForUser。新使用者不會在背景啟動。

管理員是裝置 DeviceAdminReceiver 擁有者。 profileOwner 也是與 admin 同一封裝中的 DeviceAdminReceiver，並將成為設定檔擁有者，並在新使用者中註冊為活躍管理員。設定檔擁有者套件會安裝在新使用者身上。

如果 adminExtra 不是空的，它們會儲存在裝置上，直到使用者第一次啟動。然後當呼叫 onEnable 時，額外資料會傳給管理員。

從 android.os.Build.VERSION_CODES#P 此以後，如果目標， android.os.Build.VERSION_CODES#P則是投 UserOperationException 擲而非失敗時回 null 擊。

Java 文件 android.app.admin.DevicePolicyManager.createAndManageUser(android.content.ComponentName, java.lang.String, android.content.ComponentName, android.os.PersistableBundle, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於