Interfaz ICredentialProviderCredential2 (credentialprovider.h)

  • Artículo

Extiende la interfaz ICredentialProviderCredential agregando un método que recupera el identificador de seguridad (SID) de un usuario. La credencial está asociada a ese usuario y se puede agrupar en el icono del usuario.

Herencia

La interfaz ICredentialProviderCredential2 hereda de ICredentialProviderCredential. ICredentialProviderCredential2 también tiene estos tipos de miembros:

Métodos

La interfaz ICredentialProviderCredential2 tiene estos métodos.

 
ICredentialProviderCredential2::GetUserSid

Recupera el identificador de seguridad (SID) del usuario asociado a esta credencial.

Comentarios

Esta clase es necesaria para crear un proveedor de credenciales V2. Los proveedores de credenciales V2 proporcionan una experiencia de inicio de sesión personalizada para el usuario. Esto ocurre por el proveedor de credenciales que indica a la interfaz de usuario de inicio de sesión qué opciones de inicio de sesión están disponibles para un usuario. Se recomienda que los nuevos proveedores de credenciales sean proveedores de credenciales V2.

Para crear una instancia de ICredentialProviderCredential2 , la función GetUserSid debe devolver un SID válido. Válido se define mediante el SID devuelto para uno de los usuarios enumerados actualmente por la interfaz de usuario de inicio de sesión.

Una herramienta útil para obtener los usuarios disponibles y determinar a qué usuarios desea asociar es el objeto ICredentialProviderUserArray . Este objeto contiene una lista de objetos ICredentialProviderUser que se pueden consultar para obtener información sobre los usuarios que se enumerarán. Por ejemplo, podría obtener el SID o el nombre de usuario del usuario mediante GetStringValue con un parámetro pasado de PKEY_Identity_PrimarySid o PKEY_Identity_USerName respectivamente. Incluso puede filtrar los resultados mediante SetProviderFilter para mostrar solo un subconjunto de usuarios disponibles.

El uso de ICredentialProviderUserArray es opcional, pero es una manera cómoda de obtener la información necesaria para crear valores de SID válidos. Para obtener una lista de usuarios que se enumerarán mediante la interfaz de usuario de inicio de sesión, implemente la interfaz ICredentialProviderSetUserArray para obtener el objeto ICredentialProviderUserArray de SetUserArray. La interfaz de usuario de inicio de sesión llama a SetUserArray antes de GetCredentialCount, por lo que el objeto ICredentialProviderUserArray está listo cuando un proveedor de credenciales está a punto de devolver las credenciales.

Un proveedor de credenciales V2 se representa mediante un icono que se muestra debajo del vínculo "Opciones de inicio de sesión". Para proporcionar un icono para el proveedor de credenciales, defina un CREDENTIAL_PROVIDER_FIELD_TYPE de CPFT_TILE_IMAGE en la propia credencial. A continuación, asegúrese de que guidFieldType del CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR está establecido en CPFG_CREDENTIAL_PROVIDER_LOGO. El tamaño recomendado para un icono es de 72 por 72 píxeles.

De forma similar a especificar un icono para el proveedor de credenciales, también puede especificar una cadena de texto para identificar el proveedor de credenciales. Esta cadena aparece en una ventana emergente cuando un usuario mantiene el puntero sobre el icono. Para ello, defina un CREDENTIAL_PROVIDER_FIELD_TYPE de CPFT_SMALL_TEXT en la propia credencial. A continuación, asegúrese de que guidFieldType del CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR está establecido en CPFG_CREDENTIAL_PROVIDER_LABEL. Esta cadena debe complementar el icono del proveedor de credenciales descrito anteriormente y ser lo suficientemente descriptivo como para que los usuarios entiendan lo que es. Por ejemplo, la descripción del proveedor de contraseñas de imagen es "Contraseña de imagen".

Cuándo implementar

Implemente esta interfaz para asociar iconos de credenciales a iconos de usuario específicos en la interfaz de usuario de inicio de sesión.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h

Consulte también

Proveedores de credenciales en Windows 10

ICredentialProviderCredential

ICredentialProviderCredentialEvents2