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

La méthode InitializeDecode initialise l’objet à partir d’un tableau d’octets qui contient la valeur de propriété. Le tableau d’octets 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 chaîne d’entrée.

[in] strEncodedData

Variable BSTR qui contient la valeur de propriété codée par des règles d’encodage unique (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

Spécifiez la propriété à initialiser en appelant la propriété PropertyId . Vous pouvez appeler la propriété RawData pour récupérer la valeur de propriété encodée. Appelez la méthode SetValueOnCertificate pour associer la valeur de propriété à un certificat.

Si la méthode InitializeDecode échoue, l’objet ICertProperty n’est pas initialisé et la valeur de propriété d’entrée n’est pas enregistrée. Toutefois, la propriété PropertyId conserve l’identificateur spécifié.

La méthode InitializeDecode est fournie pour vous permettre d’initialiser des propriétés et des propriétés personnalisées identifiées dans l’énumération CERTENROLL_PROPERTYID pour laquelle il n’existe aucune interface spécifique. Chacune des valeurs prises en charge dans cette énumération contient des informations sur le type de données, généralement une CRYPT_INTEGER_BLOB, que vous devez fournir à la méthode InitializeDecode . Vous pouvez utiliser l’interface IBinaryConverter pour convertir un tableau d’octets en chaîne.

Les interfaces suivantes simplifient la création des propriétés les plus courantes :

• ICertPropertyArchived
• ICertPropertyArchivedKeyHash
• ICertPropertyAutoEnroll
• ICertPropertyBackedUp
• ICertPropertyDescription
• ICertPropertyEnrollment
• ICertPropertyFriendlyName
• ICertPropertyKeyProvInfo
• ICertPropertyRenewal
• ICertPropertyRequestOriginator
• ICertPropertySHA1Hash

Spécifications

Voir aussi

ICertProperties

ICertProperty