IX509Extension::Initialize-Methode (certenroll.h)

Die Initialize-Methode initialisiert ein IX509Extension -Objekt mithilfe eines Objektbezeichners (OID) und eines Bytearrays, das die codierte Erweiterung Distinguished Encoding Rules (DER) enthält. Das DER-codierte Bytearray wird durch eine Unicode-codierte Zeichenfolge dargestellt. Diese Methode ist webfähig.

Syntax

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Die Parameter

[in] pObjectId

Zeiger auf eine IObjectId-Schnittstelle , die die Erweiterung OID enthält.

[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 DER-codierten Erweiterungswert 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

Eine Zertifikaterweiterung besteht aus einem OID, einem booleschen Wert, der angibt, ob die Erweiterung kritisch ist, und einem Bytearray, das den Erweiterungswert enthält. Die Erweiterung wird durch einen abstrakten SyntaxNotation One (ASN.1)-Standard definiert und mithilfe von DER codiert. Sie müssen das DER-codierte Bytearray als Zeichenfolge angeben, die entweder eine reine binäre Sequenz ist oder Unicode-codiert ist. Sie können den Codierungstyp angeben, der auf die Zeichenfolge angewendet werden soll, indem Sie die EncodingType-Aufzählung verwenden.

Anforderungen

Siehe auch

IX509Extension