Método ICredentialProvider::Advise (credentialprovider.h)
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.
Sintaxis
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
Parámetros
[in] pcpe
Tipo: ICredentialProviderEvents*
Puntero a una interfaz de devolución de llamada ICredentialProviderEvents que se usará como mecanismo de notificación.
[in] upAdviseContext
Tipo: UINT_PTR
Puntero a un entero que identifica de forma única qué proveedor de credenciales ha solicitado volver a enumerar.
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
No es necesario implementar el método y debe devolver E_NOTIMPL si no lo hace. Es posible que no haya ninguna razón para llamarla, por ejemplo, si la interfaz de usuario de inicio de sesión o la interfaz de usuario de credenciales nunca cambia o actualiza.
Este método permite que la interfaz de usuario de inicio de sesión y la interfaz de usuario de credenciales pasen un puntero ICredentialProviderEvents al proveedor de credenciales. Esto permite que el proveedor de credenciales tenga comunicación asincrónica de devolución de llamada con la interfaz de usuario de inicio de sesión o credencial. Por ejemplo, un proveedor de tarjetas inteligentes podría querer volver a enumerar las credenciales cuando se inserta una nueva tarjeta inteligente. Para desencadenar de nuevo la interfaz de usuario de inicio de sesión para obtener las credenciales, el proveedor de credenciales debe llamar a CredentialsChanged y proporcionar el identificador upAdviseContext .
Los proveedores de credenciales que implementan este método tienen la responsabilidad de llamar a AddRef en el ICredentialProviderEvents proporcionado. Esos proveedores de credenciales también deben llamar a Release durante el método UnAdvise .
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 |