IX509ExtensionAlternativeNames ::InitializeDecode, méthode (certenroll.h)

La méthode InitializeDecode initialise l’extension à partir d’un tableau d’octets codé par des règles d’encodage unique (DER) qui contient la valeur d’extension. Le tableau d’octets encodé est représenté par une chaîne encodée Unicode.

Syntaxe

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Paramètres

[in] Encoding

Valeur d’énumération EncodingType qui spécifie le type d’encodage Unicode appliqué à la valeur strEncodedData .

[in] strEncodedData

Variable BSTR qui contient l’extension encodée DER.

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

Vous pouvez utiliser cette méthode si vous disposez d’un objet ASN.1 ( Abstract Syntax Notation One ) encodé en DER qui contient une extension AlternativeNames . Vous devez fournir l’objet codé DER dans une chaîne encodée Unicode. Pour plus d’informations, consultez l’interface IBinaryConverter .

Vous devez appeler InitializeEncode ou InitializeDecode avant de pouvoir utiliser un objet IX509ExtensionAlternativeNames . Les deux méthodes se complètent. La méthode InitializeEncode vous permet de construire un objet d’extension ASN.1 codé en DER à 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’identificateur d’objet (OID).
• La propriété AlternativeNames récupère la collection de noms (données d’extension brutes).

Spécifications

Voir aussi

IX509ExtensionAlternativeNames