Interface ICredentialProvider (credentialprovider.h)

Expõe métodos usados na instalação e manipulação de um provedor de credenciais. Todos os provedores de credenciais devem implementar essa interface.

Herança

A interface ICredentialProvider herda da interface IUnknown . ICredentialProvider também tem estes tipos de membros:

Métodos

A interface ICredentialProvider tem esses métodos.

ICredentialProvider::Advise Permite que um provedor de credenciais inicie eventos na interface do usuário de logon ou na interface do usuário da credencial por meio de uma interface de retorno de chamada.
ICredentialProvider::GetCredentialAt Obtém uma credencial específica.
ICredentialProvider::GetCredentialCount Obtém o número de credenciais disponíveis nesse provedor de credenciais.
ICredentialProvider::GetFieldDescriptorAt Obtém metadados que descrevem um campo especificado.
ICredentialProvider::GetFieldDescriptorCount Recupera a contagem de campos no necessário para exibir as credenciais desse provedor.
ICredentialProvider::SetSerialization Define as características de serialização do provedor de credenciais.
ICredentialProvider::SetUsageScenario Define os cenários para os quais o provedor de credenciais é válido. Chamado sempre que o provedor de credenciais é inicializado.
ICredentialProvider::UnAdvise Usado pela interface do usuário de logon ou pela interface do usuário da credencial para aconselhar o provedor de credenciais de que os retornos de chamada de evento não são mais aceitos.

Comentários

Essa interface é como você vai interagir com a interface do usuário de logon e a interface do usuário de credencial para seu aplicativo.

Um provedor de credenciais instanciado é mantido durante todo o tempo de vida de uma interface do usuário de logon. Por isso, a interface do usuário de logon pode manter o estado de um provedor de credenciais. Em particular, ele lembra qual provedor e bloco forneceram uma credencial. Isso significa que você pode potencialmente armazenar informações de estado ao usar um CREDENTIAL_PROVIDER_USAGE_SCENARIO de CPUS_LOGON, CPUS_UNLOCK_WORKSTATION e CPUS_CHANGE_PASSWORD. Esse não é o caso da interface do usuário da credencial. A interface do usuário da credencial cria uma nova instância do provedor sempre que um aplicativo chama CredUIPromptForWindowsCredentials. Por isso, a interface do usuário de credencial não pode se lembrar do estado de um provedor de credenciais.

Lembre-se de que uma CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION gerada em um cenário pode ser salva e usada em um cenário de uso subsequente. Por isso, é necessário garantir que sua implementação de ICredentialProvider seja robusta o suficiente para lidar com esse cenário.

O Windows 8 adiciona novas funcionalidades à API de provedores de credenciais, principalmente a capacidade de agrupar credenciais por usuário.

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

CREDENTIAL_PROVIDER_USAGE_SCENARIO

Experiência de logon do Windows orientada pelo provedor de credenciais

Provedores de credenciais no Windows 10

ICredentialProviderCredential