DevicePolicyManager.CreateAndManageUser Metodo
Definizione
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.
Chiamato da un proprietario del dispositivo per creare un utente con il nome specificato e un determinato componente del pacchetto chiamante come proprietario del profilo.
[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
Parametri
- admin
- ComponentName
A cui DeviceAdminReceiver è associata questa richiesta.
- name
- String
Nome dell'utente.
- profileOwner
- ComponentName
Che DeviceAdminReceiver sarà proprietario del profilo. Deve trovarsi nello stesso pacchetto dell'amministratore; in caso contrario, non viene creato alcun utente e viene generata un'eccezione IllegalArgumentException.
- adminExtras
- PersistableBundle
Extra che verranno passati a onEnable del ricevitore amministratore sul nuovo utente.
- flags
- UserManagementFlags
#SKIP_SETUP_WIZARDe #MAKE_USER_EPHEMERAL#LEAVE_ALL_SYSTEM_APPS_ENABLED sono supportati.
Valori restituiti
oggetto android.os.UserHandle per l'utente creato o null se non è stato possibile creare l'utente.
- Attributi
Commenti
Chiamato da un proprietario del dispositivo per creare un utente con il nome specificato e un determinato componente del pacchetto chiamante come proprietario del profilo. L'oggetto UserHandle restituito da questo metodo non deve essere persistente perché gli handle utente vengono riciclati man mano che gli utenti vengono rimossi e creati. Se è necessario rendere persistente un identificatore per questo utente, usare UserManager#getSerialNumberForUser. Il nuovo utente non verrà avviato in background.
admin è l'oggetto che DeviceAdminReceiver è il proprietario del dispositivo. profileOwner è anche un DeviceAdminReceiver nello stesso pacchetto dell'amministratore e diventerà il proprietario del profilo e verrà registrato come amministratore attivo nel nuovo utente. Il pacchetto proprietario del profilo verrà installato nel nuovo utente.
Se adminExtras non è Null, questi verranno archiviati nel dispositivo fino a quando l'utente non viene avviato per la prima volta. Gli extra verranno quindi passati all'amministratore quando viene chiamato onEnable.
Da android.os.Build.VERSION_CODES#P poi, se la destinazione android.os.Build.VERSION_CODES#Pè , genera UserOperationException un'eccezione anziché restituire null in caso di errore.
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.