CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR estrutura (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;

Members

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 nullcadeia de caracteres Unicode terminada. 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 "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 provedores de credenciais in-box.

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

Observações

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 forem exibidos ou desaparecerem como parte do processo de aquisição de credenciais, esses campos ainda precisarão ser definidos antecipadamente. Use CREDENTIAL_PROVIDER_FIELD_STATE para ocultar ou exibir os campos conforme necessário.

Requirements