Partager via

structure CREDENTIAL_ATTRIBUTEA (wincred.h)

  • Article

La structure CREDENTIAL_ATTRIBUTE contient un attribut défini par l’application des informations d’identification. Un attribut est une paire mot clé-valeur. Il incombe à l’application de définir la signification de l’attribut.

Syntaxe

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

Membres

Keyword

Nom de l’attribut spécifique à l’application. Les noms doivent être de la forme <CompanyName>_<Name>.

Ce membre ne peut pas dépasser CRED_MAX_STRING_LENGTH (256) caractères.

Flags

Identifie les caractéristiques de l’attribut d’informations d’identification. Ce membre est réservé et doit être initialement initialisé comme zéro et non modifié pour permettre une amélioration future.

ValueSize

Longueur de valeur en octets. Ce membre ne peut pas être supérieur à CRED_MAX_VALUE_SIZE (256).

Value

Données associées à l’attribut. Par convention, si valeur est une chaîne de texte, valeur ne doit pas inclure le caractère zéro de fin et doit être au format UNICODE.

Les informations d’identification sont censées être portables. L’application doit s’assurer que les données en valeur sont portables. Il incombe à l’application de définir l’endian d’octets et l’alignement des données dans Valeur.

Remarques

Note

L’en-tête wincred.h définit CREDENTIAL_ATTRIBUTE en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête wincred.h