Compartilhar via


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

Confira também

ICredentialProvider

ICredentialProvider::UnAdvise