Freigeben über

ICertProperty::InitializeDecode-Methode (certenroll.h)

  • Artikel

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
);

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 Distinguished Encoding Rules(DER)-codierten Eigenschaftswert enthält.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Das Objekt ist bereits initialisiert.

Hinweise

Geben Sie die zu initialisierende Eigenschaft an, indem Sie die Eigenschaft PropertyId 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 bei der InitializeDecode-Methode ein Fehler auftritt, wird das ICertProperty-Objekt nicht initialisiert, und der Wert der Eingabeeigenschaft 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 identifiziert sind, für die keine bestimmte Schnittstelle vorhanden ist. Jeder der unterstützten Werte in dieser Enumeration enthält Informationen zum Typ der Daten, 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 gängigsten Eigenschaften:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certenroll.h
DLL CertEnroll.dll

Weitere Informationen

ICertProperties

ICertProperty