DevicePolicyManager.CreateAndManageUser Méthode

Définition

Espace de noms:: Android.App.Admin

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Appelé par un propriétaire d’appareil pour créer un utilisateur avec le nom spécifié et un composant donné du package appelant en tant que propriétaire de profil.

[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

Paramètres

admin: ComponentName

Auquel DeviceAdminReceiver cette requête est associée.

name: String

Nom de l’utilisateur.

profileOwner: ComponentName

Qui DeviceAdminReceiver sera propriétaire du profil. Doit se trouver dans le même package que l’administrateur, sinon aucun utilisateur n’est créé et une exception IllegalArgumentException est levée.

adminExtras: PersistableBundle

Extras qui seront transmis à onEnable du récepteur d’administration sur le nouvel utilisateur.

flags: UserManagementFlags

#SKIP_SETUP_WIZARD, #MAKE_USER_EPHEMERAL et #LEAVE_ALL_SYSTEM_APPS_ENABLED sont pris en charge.

Retours

UserHandle

l’objet android.os.UserHandle de l’utilisateur créé ou null si l’utilisateur n’a pas pu être créé.

Attributs: RegisterAttribute

Remarques

Appelé par un propriétaire d’appareil pour créer un utilisateur avec le nom spécifié et un composant donné du package appelant en tant que propriétaire de profil. UserHandle retourné par cette méthode ne doit pas être conservé, car les handles utilisateur sont recyclés lorsque les utilisateurs sont supprimés et créés. Si vous devez conserver un identificateur pour cet utilisateur, utilisez UserManager#getSerialNumberForUser. Le nouvel utilisateur ne sera pas démarré en arrière-plan.

l’administrateur est le DeviceAdminReceiver propriétaire de l’appareil. profileOwner est également un DeviceAdminReceiver dans le même package que l’administrateur, et devient le propriétaire du profil et sera inscrit en tant qu’administrateur actif sur le nouvel utilisateur. Le package propriétaire du profil est installé sur le nouvel utilisateur.

Si les adminExtras ne sont pas null, ils sont stockés sur l’appareil jusqu’à ce que l’utilisateur soit démarré pour la première fois. Ensuite, les extras seront transmis à l’administrateur quand onEnable est appelé.

À partir de android.os.Build.VERSION_CODES#P là, si le android.os.Build.VERSION_CODES#Pciblage est activé, lève UserOperationException au lieu de retourner null en cas d’échec.

Java documentation pour android.app.admin.DevicePolicyManager.createAndManageUser(android.content.ComponentName, java.lang.String, android.content.ComponentName, android.os.PersistableBundle, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à