Compartilhar via

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

  • Artigo

Sinaliza à interface do usuário de logon ou à interface do usuário de credencial que a lista enumerada de credenciais foi alterada. Isso acontece quando o número de credenciais é alterado, as credenciais individuais são alteradas ou o número de campos disponíveis é alterado. Esse é um método assíncrono.

Sintaxe

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

Parâmetros

[in] upAdviseContext

Tipo: UINT_PTR

Um ponteiro para um inteiro que identifica exclusivamente qual provedor de credenciais solicitou a renumeração. O provedor de credenciais deve passar de volta o ponteiro de interface que recebeu de Advise nesse parâmetro.

Retornar valor

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

No passado, muitos provedores de credenciais usavam ICredentialProviderEvents::CredentialsChanged para atualizar a interface do usuário. Embora isso funcione, ele causa uma renumeração de todas as credenciais do provedor de credenciais de chamada. O processamento desse evento pode, em algumas circunstâncias, levar a alterações de foco ou flash na interface do usuário devido a essa renumeração. Portanto, não é recomendável usar ICredentialProviderEvents::CredentialsChanged apenas para atualizações de interface do usuário. A nova recomendação é a seguinte:

  • Use ICredentialProviderEvents::CredentialsChanged somente se um provedor de credenciais precisar fazer um logon automático ou alterar o número de credenciais que ele está enumerando.
  • Use ICredentialProviderCredentialEvents2 para atualizar a interface do usuário de Logon ou a interface do usuário de credencial de um provedor de credenciais.

Requisitos

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