Partilhar via


estrutura CREDENTIAL_ATTRIBUTEA (wincred.h)

A estrutura CREDENTIAL_ATTRIBUTE contém um atributo definido pelo aplicativo da credencial. Um atributo é um par de palavra-chave-valor. Cabe ao aplicativo definir o significado do atributo.

Sintaxe

typedef struct _CREDENTIAL_ATTRIBUTEA {
  LPSTR  Keyword;
  DWORD  Flags;
  DWORD  ValueSize;
  LPBYTE Value;
} CREDENTIAL_ATTRIBUTEA, *PCREDENTIAL_ATTRIBUTEA;

Membros

Keyword

Nome do atributo específico do aplicativo. Os nomes devem ser do formulário <CompanyName>_<Name>.

Esse membro não pode ter mais de CRED_MAX_STRING_LENGTH (256) caracteres.

Flags

Identifica as características do atributo de credencial. Esse membro é reservado e deve ser originalmente inicializado como zero e não alterado de outra forma para permitir o aprimoramento futuro.

ValueSize

Comprimento do valor em bytes. Esse membro não pode ser maior que CRED_MAX_VALUE_SIZE (256).

Value

Dados associados ao atributo. Por convenção, se Value for uma cadeia de caracteres de texto, Valor não deverá incluir o caractere zero à direita e deve estar em UNICODE.

Espera-se que as credenciais sejam portáteis. O aplicativo deve ter cuidado para garantir que os dados em valor sejam portáteis. É responsabilidade do aplicativo definir o byte-endian e o alinhamento dos dados em Value.

Observações

Nota

O cabeçalho wincred.h define CREDENTIAL_ATTRIBUTE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho wincred.h