structure CERT_KEY_ATTRIBUTES_INFO (wincrypt.h)

La structure CERT_KEY_ATTRIBUTES_INFO contient des informations supplémentaires facultatives sur la clé publique en cours de certification. Il peut inclure un identificateur de clé, une indication de l’utilisation prévue de cette clé ou une indication de la période d’utilisation de la clé privée correspondante.

CryptDecodeObject crée une instance de cette structure lorsqu’elle est effectuée sur le membre Value d’une structure CERT_EXTENSION avec le membre pszObjId de la structure défini sur szOID_KEY_ATTRIBUTES.

Une instance de cette structure peut être utilisée comme entrée dans CryptEncodeObject pour créer un CERT_EXTENSION approprié.

Syntaxe

typedef struct _CERT_KEY_ATTRIBUTES_INFO {
  CRYPT_DATA_BLOB            KeyId;
  CRYPT_BIT_BLOB             IntendedKeyUsage;
  PCERT_PRIVATE_KEY_VALIDITY pPrivateKeyUsagePeriod;
} CERT_KEY_ATTRIBUTES_INFO, *PCERT_KEY_ATTRIBUTES_INFO;

Membres

KeyId

Une structure CRYPT_DATA_BLOB avec un identificateur unique d’une clé.

IntendedKeyUsage

CRYPT_BIT_BLOB avec le membre pbData indiquant l’objectif prévu de la clé. Pour obtenir la liste des valeurs de bits d’utilisation, consultez le membre RestrictedKeyUsage de la structure CERT_KEY_USAGE_RESTRICTION_INFO .

Ce membre peut être utilisé pour rechercher la clé ou le certificat correct d’un utilisateur disposant de plusieurs clés ou certificats. Son indication d’utilisation est un champ consultatif, uniquement, et n’implique pas que l’utilisation de la clé soit limitée à l’objectif indiqué. La liste des utilisations prévues n’est pas nécessairement complète et le champ peut être omis. Si une clé doit être limitée à un élément particulier, utilisez une extension CERT_KEY_USAGE_RESTRICTION_INFO doit être utilisée.

pPrivateKeyUsagePeriod

Pointeur vers une structure CERT_PRIVATE_KEY_VALIDITY qui indique la période d’utilisation de la clé privée correspondant à la clé publique certifiée. Ce membre est facultatif et peut être défini sur NULL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	wincrypt.h

Voir aussi

CERT_EXTENSION

CERT_PRIVATE_KEY_VALIDITY

CRYPT_BIT_BLOB

CRYPT_INTEGER_BLOB

CryptDecodeObject