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
);
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 |
|---|---|
|
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:
- ICertPropertyArchived
- ICertPropertyArchivedKeyHash
- ICertPropertyAutoEnroll
- ICertPropertyBackedUp
- ICertPropertyDescription
- ICertPropertyEnrollment
- ICertPropertyFriendlyName
- ICertPropertyKeyProvInfo
- ICertPropertyRenewal
- ICertPropertyRequestOriginator
- ICertPropertySHA1Hash
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 |