Share via

Método ICredentialProviderEvents::CredentialsChanged (credentialprovider.h)

  • Artículo

Indica la interfaz de usuario de inicio de sesión o la interfaz de usuario de credenciales que ha cambiado la lista enumerada de credenciales. Esto sucede cuando cambia el número de credenciales, las credenciales individuales cambian o el número de campos disponibles. Se trata de un método asincrónico.

Sintaxis

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

Parámetros

[in] upAdviseContext

Tipo: UINT_PTR

Puntero a un entero que identifica de forma única qué proveedor de credenciales ha solicitado volver a enumerar. El proveedor de credenciales debe devolver el puntero de interfaz que recibió de Advise en este parámetro.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

En el pasado, muchos proveedores de credenciales usaban ICredentialProviderEvents::CredentialsChanged para actualizar la interfaz de usuario. Aunque esto funciona, provoca una nueva enumeración de todas las credenciales del proveedor de credenciales que realiza la llamada. El procesamiento de este evento puede, en algunas circunstancias, provocar cambios de foco o parpadeo en la interfaz de usuario debido a esta nueva enumeración. Por lo tanto, no se recomienda usar ICredentialProviderEvents::CredentialsChanged únicamente para las actualizaciones de la interfaz de usuario. La nueva recomendación es la siguiente:

  • Use ICredentialProviderEvents::CredentialsChanged solo si un proveedor de credenciales necesita realizar un inicio de sesión automático o cambiar el número de credenciales que está enumerando.
  • Use ICredentialProviderCredentialEvents2 para actualizar la interfaz de usuario de inicio de sesión de un proveedor de credenciales o la interfaz de usuario de credenciales.

Requisitos

Requisito Value
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