DevicePolicyManager.CreateAndManageUser 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.
Chamado por um proprietário do dispositivo para criar um usuário com o nome especificado e um determinado componente do pacote de chamada como proprietário do perfil.
[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
Parâmetros
- admin
- ComponentName
À qual DeviceAdminReceiver essa solicitação está associada.
- name
- String
O nome do usuário.
- profileOwner
- ComponentName
Que DeviceAdminReceiver será o proprietário do perfil. Tem que estar no mesmo pacote que o administrador, caso contrário, nenhum usuário é criado e um IllegalArgumentException é gerado.
- adminExtras
- PersistableBundle
Extras que serão passados para onEnable do receptor de administrador no novo usuário.
- flags
- UserManagementFlags
#SKIP_SETUP_WIZARDe #MAKE_USER_EPHEMERAL#LEAVE_ALL_SYSTEM_APPS_ENABLED têm suporte.
Retornos
o android.os.UserHandle objeto para o usuário criado ou null se o usuário não pôde ser criado.
- Atributos
Comentários
Chamado por um proprietário do dispositivo para criar um usuário com o nome especificado e um determinado componente do pacote de chamada como proprietário do perfil. O UserHandle retornado por esse método não deve ser persistente, pois os identificadores de usuário são reciclados à medida que os usuários são removidos e criados. Se você precisar persistir um identificador para esse usuário, use UserManager#getSerialNumberForUser. O novo usuário não será iniciado em segundo plano.
o administrador é o DeviceAdminReceiver proprietário do dispositivo. profileOwner também é um DeviceAdminReceiver no mesmo pacote que o administrador e se tornará o proprietário do perfil e será registrado como um administrador ativo no novo usuário. O pacote do proprietário do perfil será instalado no novo usuário.
Se os adminExtras não forem nulos, eles serão armazenados no dispositivo até que o usuário seja iniciado pela primeira vez. Em seguida, os extras serão passados para o administrador quando onEnable for chamado.
A partir de android.os.Build.VERSION_CODES#P então, se o direcionamento android.os.Build.VERSION_CODES#Pfor direcionado, será lançado UserOperationException em vez de retornar null com falha.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.