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を使用します。新しいユーザーはバックグラウンドで開始されません。

admin はデバイス所有者である DeviceAdminReceiver です。 profileOwner は、管理者と同じパッケージ内の DeviceAdminReceiver でもあり、プロファイル所有者になり、新しいユーザーのアクティブな管理者として登録されます。プロファイル所有者パッケージが新しいユーザーにインストールされます。

adminExtras が null でない場合は、ユーザーが初めて起動するまでデバイスに格納されます。その後、onEnable が呼び出されると、エクストラが管理者に渡されます。

android.os.Build.VERSION_CODES#P以降、android.os.Build.VERSION_CODES#Pをターゲットにすると、失敗した場合にnullを返す代わりにUserOperationExceptionがスローされます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象