ICertProperty::InitializeDecode-Methode (certenroll.h)

Die InitializeDecode-Methode initialisiert das Objekt aus einem Bytearray, das den Eigenschaftswert enthält. Das Bytearray wird durch eine Unicode-codierte Zeichenfolge dargestellt.

Syntax

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Die Parameter

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die Eingabezeichenfolge angewendet wird.

[in] strEncodedData

Eine BSTR-Variable , die den Wert der distinguished Encoding Rules (DER)-codierten Eigenschaft enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Bemerkungen

Geben Sie die Eigenschaft an, die initialisiert werden soll, indem Sie die PropertyId-Eigenschaft aufrufen. Sie können die RawData-Eigenschaft aufrufen, um den codierten Eigenschaftswert abzurufen. Rufen Sie die SetValueOnCertificate-Methode auf, um den Eigenschaftswert einem Zertifikat zuzuordnen.

Wenn die InitializeDecode-Methode fehlschlägt, wird das ICertProperty-Objekt nicht initialisiert, und der Eingabeeigenschaftswert wird nicht gespeichert. Die PropertyId-Eigenschaft behält jedoch den angegebenen Bezeichner bei.

Die InitializeDecode-Methode wird bereitgestellt, damit Sie benutzerdefinierte Eigenschaften und Eigenschaften initialisieren können, die in der CERTENROLL_PROPERTYID Enumeration angegeben sind, für die keine bestimmte Schnittstelle vorhanden ist. Jeder der unterstützten Werte in dieser Enumeration enthält Informationen über den Datentyp, in der Regel eine CRYPT_INTEGER_BLOB, die Sie für die InitializeDecode-Methode angeben müssen. Sie können die IBinaryConverter-Schnittstelle verwenden, um ein Bytearray in eine Zeichenfolge zu konvertieren.

Die folgenden Schnittstellen vereinfachen die Erstellung der am häufigsten verwendeten Eigenschaften:

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

Anforderungen

Siehe auch

ICertProperties-

ICertProperty-