IX509ExtensionSubjectKeyIdentifier ::InitializeEncode, méthode (certenroll.h)

La méthode InitializeEncode initialise l’extension à partir d’un tableau d’octets qui contient l’identificateur de clé. Le tableau d’octets est représenté par une chaîne encodée Unicode.

Syntaxe

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strKeyIdentifier
);

Paramètres

[in] Encoding

Valeur d’énumération EncodingType qui spécifie le type d’encodage Unicode appliqué au paramètre strKeyIdentifier .

[in] strKeyIdentifier

Variable BSTR qui contient l’identificateur de clé.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

En règle générale, la valeur d’entrée doit être un hachage SHA-1 de la clé publique contenue dans le certificat de signature de l’autorité de certification. La méthode associe la valeur à l’identificateur d’objet XCN_OID_SUBJECT_KEY_IDENTIFIER (2.5.29.14) et l’encode à l’aide de règles d’encodage unique (DER).

Vous devez appeler InitializeEncode ou InitializeDecode avant de pouvoir utiliser un objet IX509ExtensionSubjectKeyIdentifier . Les deux méthodes se complètent. La méthode InitializeEncode vous permet de construire un objet d’extension de syntaxe abstraite encodé en DER (ASN.1) à partir de données brutes, et la méthode InitializeDecode vous permet d’initialiser les données brutes à partir d’un objet encodé.

Vous pouvez récupérer les propriétés suivantes pour cette extension :

• La propriété Critical identifie si l’extension est critique. Vous pouvez également spécifier cette propriété.
• La propriété ObjectId récupère l’OID.
• La propriété AuthorityKeyIdentifier récupère les données brutes.

Spécifications

Voir aussi

IX509ExtensionSubjectKeyIdentifier