Interface ICredentialProviderCredential2 (credentialprovider.h)

Estende a interface ICredentialProviderCredential adicionando um método que recupera o SID (identificador de segurança) de um usuário. A credencial está associada a esse usuário e pode ser agrupada no bloco do usuário.

Herança

A interface ICredentialProviderCredential2 herda de ICredentialProviderCredential. ICredentialProviderCredential2 também tem estes tipos de membros:

Métodos

A interface ICredentialProviderCredential2 tem esses métodos.

ICredentialProviderCredential2::GetUserSid Recupera o SID (identificador de segurança) do usuário associado a essa credencial.

Comentários

Essa classe é necessária para criar um provedor de credenciais V2. Os provedores de credenciais V2 fornecem uma experiência de logon personalizada para o usuário. Isso ocorre pelo provedor de credenciais informando à interface do usuário de logon quais opções de entrada estão disponíveis para um usuário. É recomendável que novos provedores de credenciais sejam provedores de credenciais V2.

Para criar uma instância ICredentialProviderCredential2 , um SID válido precisa ser retornado pela função GetUserSid . Válido é definido pelo SID retornado sendo para um dos usuários atualmente enumerados pela interface do usuário de logon.

Uma ferramenta útil para obter os usuários disponíveis e determinar com quais você deseja associar é o objeto ICredentialProviderUserArray . Este objeto contém uma lista de objetos ICredentialProviderUser que podem ser consultados para obter informações sobre os usuários que serão enumerados. Por exemplo, você pode obter o SID ou o nome de usuário do usuário usando GetStringValue com um parâmetro passado de PKEY_Identity_PrimarySid ou PKEY_Identity_USerName respectivamente. Você pode até mesmo filtrar os resultados usando SetProviderFilter para exibir apenas um subconjunto de usuários disponíveis.

O uso de ICredentialProviderUserArray é opcional, mas é uma maneira conveniente de obter as informações necessárias para fazer valores de SID válidos. Para obter uma lista de usuários que serão enumerados pela interface do usuário de Logon, implemente a interface ICredentialProviderSetUserArray para obter o objeto ICredentialProviderUserArray de SetUserArray. A interface do usuário de logon chama SetUserArray antes de GetCredentialCount, portanto, o objeto ICredentialProviderUserArray está pronto quando um provedor de credenciais está prestes a retornar credenciais.

Um provedor de credenciais V2 é representado por um ícone exibido abaixo do link "Opções de entrada". Para fornecer um ícone para o provedor de credenciais, defina uma CREDENTIAL_PROVIDER_FIELD_TYPE de CPFT_TILE_IMAGE na própria credencial. Em seguida, verifique se guidFieldType do CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR está definido como CPFG_CREDENTIAL_PROVIDER_LOGO. O tamanho recomendado para um ícone é de 72 por 72 pixels.

Semelhante à especificação de um ícone para seu provedor de credenciais, você também pode especificar uma cadeia de caracteres de texto para identificar seu provedor de credenciais. Essa cadeia de caracteres aparece em uma janela pop-up quando um usuário passa o mouse sobre o ícone. Para fazer isso, defina uma CREDENTIAL_PROVIDER_FIELD_TYPE de CPFT_SMALL_TEXT na própria credencial. Em seguida, verifique se guidFieldType do CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR está definido como CPFG_CREDENTIAL_PROVIDER_LABEL. Essa cadeia de caracteres deve complementar o ícone do provedor de credenciais descrito acima e ser descritivo o suficiente para que os usuários entendam o que é. Por exemplo, a descrição do provedor de senha de imagem é "Senha de Imagem".

Quando implementar

Implemente essa interface para associar blocos de credenciais a blocos de usuário específicos na interface do usuário de logon.

Requisitos

Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	credentialprovider.h

Confira também

Provedores de credenciais no Windows 10

ICredentialProviderCredential

ICredentialProviderCredentialEvents2