Interfaz ICredentialProvider (credentialprovider.h)
Expone los métodos usados en la configuración y manipulación de un proveedor de credenciales. Todos los proveedores de credenciales deben implementar esta interfaz.
Herencia
La interfaz ICredentialProvider hereda de la interfaz IUnknown . ICredentialProvider también tiene estos tipos de miembros:
Métodos
La interfaz ICredentialProvider tiene estos métodos.
| ICredentialProvider::Advise Permite que un proveedor de credenciales inicie eventos en la interfaz de usuario de inicio de sesión o en la interfaz de usuario de credenciales mediante una interfaz de devolución de llamada. |
| ICredentialProvider::GetCredentialAt Obtiene una credencial específica. |
| ICredentialProvider::GetCredentialCount Obtiene el número de credenciales disponibles en este proveedor de credenciales. |
| ICredentialProvider::GetFieldDescriptorAt Obtiene metadatos que describen un campo especificado. |
| ICredentialProvider::GetFieldDescriptorCount Recupera el recuento de campos de los necesarios para mostrar las credenciales de este proveedor. |
| ICredentialProvider::SetSerialization Establece las características de serialización del proveedor de credenciales. |
| ICredentialProvider::SetUsageScenario Define los escenarios para los que el proveedor de credenciales es válido. Se llama cada vez que se inicializa el proveedor de credenciales. |
| ICredentialProvider::UnAdvise Usado por la interfaz de usuario de inicio de sesión o la interfaz de usuario de credenciales para avisar al proveedor de credenciales que ya no se aceptan devoluciones de llamada de eventos. |
Comentarios
Esta interfaz es cómo interactuará con la interfaz de usuario de inicio de sesión y la interfaz de usuario de credenciales de la aplicación.
Se mantiene un proveedor de credenciales con instancias durante toda la vigencia de una interfaz de usuario de inicio de sesión. Por este motivo, la interfaz de usuario de inicio de sesión puede mantener el estado de un proveedor de credenciales. En concreto, recuerda qué proveedor y icono proporcionaron una credencial. Esto significa que puede almacenar información de estado cuando se usa una CREDENTIAL_PROVIDER_USAGE_SCENARIO de CPUS_LOGON, CPUS_UNLOCK_WORKSTATION y CPUS_CHANGE_PASSWORD. Este no es el caso de la interfaz de usuario de credenciales. La interfaz de usuario de credenciales crea una nueva instancia del proveedor cada vez que una aplicación llama a CredUIPromptForWindowsCredentials. Por este motivo, la interfaz de usuario de credenciales no puede recordar el estado de un proveedor de credenciales.
Tenga en cuenta que un CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION generado en un escenario podría guardarse y usarse en un escenario de uso posterior. Por este motivo, es necesario asegurarse de que la implementación de ICredentialProvider es lo suficientemente sólida como para controlar este escenario.
Windows 8 agrega nueva funcionalidad en la API de proveedores de credenciales, principalmente la capacidad de agrupar las credenciales por usuario.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | credentialprovider.h |
Consulte también
CREDENTIAL_PROVIDER_USAGE_SCENARIO
Experiencia de inicio de sesión de Windows controlada por el proveedor de credenciales