]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Protocol/UserManager.h
MdePkg FirmwareManagement.h: Fix typo EFI_SECURITY_VIOLATIO
[mirror_edk2.git] / MdePkg / Include / Protocol / UserManager.h
index 9e5aa6bbcc297388ebdabd2d49252ab7575ef6bc..8c9f662228455f61f59dcfe19c3b46b78ce6e9fb 100644 (file)
@@ -1,9 +1,9 @@
 /** @file\r
-  UEFI 2.2 User Manager Protocol definition.\r
+  UEFI User Manager Protocol definition.\r
 \r
   This protocol manages user profiles.\r
 \r
-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>\r
   This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -445,13 +445,16 @@ EFI_STATUS
 /**\r
   Called by credential provider to notify of information change.\r
 \r
-  This function allows the credential provider to notify the User Identity Manager when user status has \r
-  changed while deselected.\r
+  This function allows the credential provider to notify the User Identity Manager when user status  \r
+  has changed.\r
   If the User Identity Manager doesn't support asynchronous changes in credentials, then this function \r
   should return EFI_UNSUPPORTED. \r
-  If the User Identity Manager supports this, it will call User() to get the user identifier and then \r
-  GetNextInfo() and GetInfo() in the User Credential Protocol to get all of the information \r
-  from the credential and add it.\r
+  If current user does not exist, and the credential provider can identify a user, then make the user \r
+  to be current user and signal the EFI_EVENT_GROUP_USER_PROFILE_CHANGED event.\r
+  If current user already exists, and the credential provider can identify another user, then switch \r
+  current user to the newly identified user, and signal the EFI_EVENT_GROUP_USER_PROFILE_CHANGED event.\r
+  If current user was identified by this credential provider and now the credential provider cannot identify \r
+  current user, then logout current user and signal the EFI_EVENT_GROUP_USER_PROFILE_CHANGED event.\r
 \r
   @param[in] This          Points to this instance of the EFI_USER_MANAGER_PROTOCOL.\r
   @param[in] Changed       Handle on which is installed an instance of the\r
@@ -511,6 +514,8 @@ EFI_STATUS
   This function changes user information.  If NULL is pointed to by UserInfo, then a new user \r
   information record is created and its handle is returned in UserInfo. Otherwise, the existing one is \r
   replaced.\r
+  If EFI_USER_INFO_IDENTITY_POLICY_RECORD is changed, it is the caller's responsibility to keep it to \r
+  be synced with the information on credential providers.\r
   If EFI_USER_INFO_EXCLUSIVE is specified in Info and a user information record of the same \r
   type already exists in the user profile, then EFI_ACCESS_DENIED will be returned and \r
   UserInfo will point to the handle of the existing record.\r