Partager via


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

La méthode InitializeEncode initialise l’extension à partir d’un identificateur d’objet de modèle (OID) et des numéros de version principaux et secondaires. Cette méthode est activée sur le web.

Syntaxe

HRESULT InitializeEncode(
  [in] IObjectId *pTemplateOid,
  [in] LONG      MajorVersion,
  [in] LONG      MinorVersion
);

Paramètres

[in] pTemplateOid

Pointeur vers une interface IObjectId qui représente l’OID du modèle.

[in] MajorVersion

Variable LONG qui contient le numéro de version principal du modèle. La valeur par défaut est zéro (0).

[in] MinorVersion

Variable LONG qui contient le numéro de version secondaire du modèle. La valeur par défaut est zéro (0).

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 devez appeler InitializeEncode ou InitializeDecode avant de pouvoir utiliser un objet IX509ExtensionTemplate . Les deux méthodes se complètent. La méthode InitializeEncode vous permet de construire un objet d’extension d’extension de syntaxe abstraite (ASN.1) encodé par des règles d’encodage unique (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’OID.
  • Les propriétés MajorVersion et MinorVersion récupèrent les informations de version.
  • La propriété TemplateOid récupère l’OID du modèle.

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 une structure ASN.1 encodée à partir de données brutes, et la méthode InitializeDecode vous permet d’initialiser les données brutes à partir d’une structure ASN.1 encodée. Vous pouvez récupérer les données brutes de l’extension en appelant les propriétés MajorVersion, MinorVersion et TemplateOid .

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

IX509ExtensionTemplate