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

La méthode InitializeEncode initialise l’extension à partir d’une collection IAlternativeNames .

Syntaxe

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

Paramètres

[in] pValue

Pointeur vers une interface IAlternativeNames .

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

La méthode associe la collection de noms à l’identificateur d’objet XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17) et l’encode à l’aide de règles d’encodage unique (DER).

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 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é AlternativeNames récupère la collection de noms (données d’extension brutes).

Spécifications

Voir aussi

IX509ExtensionAlternativeNames