estrutura CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR (credentialprovider.h)

Descreve um único campo em uma credencial. Por exemplo, uma cadeia de caracteres ou uma imagem de usuário.

Sintaxe

typedef struct _CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR {
  DWORD                          dwFieldID;
  CREDENTIAL_PROVIDER_FIELD_TYPE cpft;
  LPWSTR                         pszLabel;
  GUID                           guidFieldType;
} CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR;

Membros

dwFieldID

Tipo: DWORD

A ID exclusiva do campo. Os campos devem ter um identificador exclusivo em comparação com todos os outros campos em um determinado provedor de credenciais. Isso é verdadeiro, independentemente de os campos serem exibidos ou ocultos.

cpft

Tipo: CREDENTIAL_PROVIDER_FIELD_TYPE

O tipo de campo.

pszLabel

Tipo: LPWSTR

Um ponteiro para um buffer que contém o nome amigável do campo como uma cadeia de caracteres Unicode terminada em nulo. Isso é usado para fins de acessibilidade e enfileiramento. Por exemplo, alguns campos padrão teriam nomes amigáveis de "Nome de usuário", "Senha" e "Fazer logon em".

guidFieldType

Tipo: GUID

Um GUID que identifica exclusivamente um tipo de campo. Esse membro permite encapsular a funcionalidade fornecida pelos provedores de credenciais existentes em seus próprios provedores. Não é recomendável encapsular provedores de credenciais, pois isso pode levar a um comportamento inesperado que desabilita os provedores de credenciais in-box.

A tabela a seguir lista os valores guidFieldType compatíveis com o Windows. Eles são definidos em Shlguid.h.

Valor	Significado
CPFG_LOGON_USERNAME da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b	O nome de usuário inserido em uma caixa de texto.
CPFG_LOGON_PASSWORD 60624cfa-a477-47b1-8a8e-3a4a19981827	A senha inserida em uma caixa de texto.
CPFG_SMARTCARD_USERNAME 3e1ecf69-568c-4d96-9d59-46444174e2d6	O nome de usuário obtido de uma cartão inteligente inserida.
CPFG_SMARTCARD_PIN 4fe5263b-9181-46c1-b0a4-9dedd4db7dea	O PIN obtido de uma cartão inteligente inserida.
CPFG_CREDENTIAL_PROVIDER_LOGO 2d837775-f6cd-464e-a745-482fd0b47493	Introduzido no Windows 8: a imagem usada para representar um provedor de credenciais na página de logon.
CPFG_CREDENTIAL_PROVIDER_LABEL 286BBFF3-BAD4-438F-B007-79B7267C3D48	Introduzido no Windows 8: o rótulo associado a um provedor de credenciais na página de logon.

Comentários

Cada elemento de interface do usuário apresentado ao usuário em um bloco é definido pelo provedor de credenciais como um campo. O CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR é como o provedor de credenciais identifica os campos. Depois que um campo tiver sido definido para um cenário de uso específico, ele não poderá ser adicionado ou subtraído. Os provedores de credenciais precisam definir totalmente todos os campos antes de enumerar blocos. Se os campos aparecerem ou desaparecerem como parte do processo de aquisição de credenciais, esses campos ainda não serão definidos antecipadamente. Use CREDENTIAL_PROVIDER_FIELD_STATE para ocultar ou exibir os campos conforme necessá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]
Cabeçalho	credentialprovider.h