Método ICredentialProvider::Advise (credentialprovider.h)
Permite que um provedor de credenciais inicie eventos na interface do usuário de logon ou na interface do usuário de credencial por meio de uma interface de retorno de chamada.
Sintaxe
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
Parâmetros
[in] pcpe
Tipo: ICredentialProviderEvents*
Um ponteiro para uma interface de retorno de chamada ICredentialProviderEvents a ser usada como o mecanismo de notificação.
[in] upAdviseContext
Tipo: UINT_PTR
Um ponteiro para um inteiro que identifica exclusivamente qual provedor de credenciais solicitou a renumeração.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
O método não precisa ser implementado e deve retornar E_NOTIMPL se não o fizer. Talvez não haja nenhum motivo para chamá-lo, como se a interface do usuário de logon ou a interface do usuário de credencial nunca forem alteradas ou atualizadas.
Esse método permite que a interface do usuário de Logon e a interface do usuário de credencial passem um ponteiro ICredentialProviderEvents para o provedor de credenciais. Isso permite que o provedor de credenciais tenha comunicação de retorno de chamada assíncrona com a interface do usuário de Logon ou credencial. Por exemplo, um provedor de cartão inteligente pode querer enumerar as credenciais novamente quando uma nova cartão inteligente for inserida. Para disparar a interface do usuário do Logon para obter credenciais novamente, o provedor de credenciais deve chamar CredentialsChanged fornecendo o identificador upAdviseContext .
Os provedores de credenciais que implementam esse método têm a responsabilidade de chamar AddRef nos ICredentialProviderEvents fornecidos. Esses provedores de credenciais também precisam chamar Release durante o método UnAdvise .
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | credentialprovider.h |