Partager via


IX509ExtensionBasicConstraints ::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.

Retourner le code/la valeur Descriptif
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
L’objet est déjà initialisé.

Remarques

Vous pouvez utiliser cette méthode si vous disposez d’un objet ASN.1 ( Abstract Syntax Notation One ) codé en DER qui contient une extension BasicConstraints . 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 IX509ExtensionBasicConstraints . 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é IsCA identifie si le sujet du certificat peut être une autorité de certification.
  • La propriété PathLenConstraint identifie la profondeur de la chaîne d’autorité de certification subordonnée.

Spécifications

Requirement Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
Header certenroll.h
DLL CertEnroll.dll

Voir aussi

IX509ExtensionBasicConstraints