IX509Extension ::Initialize, méthode (certenroll.h)

Article
02/26/2024

La méthode Initialize initialise un objet IX509Extension à l’aide d’un identificateur d’objet (OID) et d’un tableau d’octets qui contient l’extension encodée Distinguished Encoding Rules (DER). Le tableau d’octets encodé en DER est représenté par une chaîne encodée en Unicode. Cette méthode est activée sur le web.

Syntaxe

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Paramètres

[in] pObjectId

Pointeur vers une interface IObjectId qui contient l’OID d’extension.

[in] Encoding

Valeur d’énumération EncodingType qui spécifie le type d’encodage Unicode appliqué à la chaîne d’entrée.

[in] strEncodedData

Variable BSTR qui contient la valeur d’extension encodée de 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 sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code/valeur de retour	Description
CERTSRV_E_PROPERTY_EMPTY	L’OID est introuvable.

Remarques

Une extension de certificat se compose d’un OID, d’une valeur booléenne qui identifie si l’extension est critique et d’un tableau d’octets qui contient la valeur de l’extension. L’extension est définie par une norme ASN.1 ( Abstract Syntax Notation One ) et est encodée à l’aide de DER. Vous devez spécifier le tableau d’octets encodé en DER sous la forme d’une chaîne qui est une séquence binaire pure ou est encodée au format Unicode. Vous pouvez spécifier le type d’encodage à appliquer à la chaîne à l’aide de l’énumération EncodingType .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h
DLL	CertEnroll.dll

Voir aussi

IX509Extension

Partager via