IX509CertificateRequestPkcs7::InitializeDecode-Methode (certenroll.h)

Die InitializeDecode-Methode decodiert ein vorhandenes signiertes oder nicht signiertes PKCS #7-Anforderungsobjekt und verwendet es zum Initialisieren des neuen PKCS #7-Objekts. Die vorhandene Anforderung ist in einem Bytearray enthalten, das mithilfe von Distinguished Encoding Rules (DER) codiert wurde, wie durch den Standard " Abstrakte Syntax Notation One (ASN.1)" definiert. Das Bytearray wird durch eine Zeichenfolge dargestellt, die entweder eine reine binäre Sequenz ist oder Unicode-codiert ist.

Syntax

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

Die Parameter

[in] strEncodedData

Eine BSTR-Variable , die die DER-codierte Anforderung enthält.

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die Eingabezeichenfolge angewendet wird, die die DER-codierte Anforderung enthält. Der Standardwert ist XCN_CRYPT_STRING_BASE64.

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

Die InitializeDecode-Methode :

• Decodiert die für die Eingabe angegebene PKCS #7-Anforderung.
• Verwendet das decodierte Objekt, um eine innere PKCS #10-Anforderung mit den folgenden Auflistungen zu erstellen:
  • Eine leere ICryptAttributes-Auflistung .
  • Eine leere IX509Extensions-Sammlung .
  • Eine leere IObjectIds-Auflistung für kritische Erweiterungen.
  • Eine leere IObjectIds-Auflistung für Attribut- und Erweiterungs-OIDs, die von der neuen Anforderung unterdrückt werden sollen.
• Fügt der IX509Extensions-Auflistung die decodierten Erweiterungen hinzu.
• Fügt der ICryptAttributes-Auflistung die decodierten Attribute hinzu.
• Legt die ClientId-Eigenschaft fest.
• Legt die TemplateObjectId-Eigenschaft fest.
• Verwendet die Signatur für die ursprüngliche PKCS #7-Anforderung, um ein neues ISignerCertificate -Objekt zu erstellen.
• Ruft ein IX509SignatureInformation -Objekt aus dem ISignerCertificate -Objekt ab.
• Initialisiert das neue IX509SignatureInformation -Objekt mithilfe der ursprünglichen Signatur- und Hashalgorithmen.
• Legt die PKCS #10-Anforderung als inneres Anforderungsobjekt fest.

Standardmäßig geht die InitializeDecode-Methode davon aus, dass die zu decodierende Zertifikatanforderung für einen Endbenutzer gilt. Ab Windows 8 und Windows Server 2012 können Sie dieses Standardverhalten ändern. Rufen Sie nach dem Erstellen einer Instanz der IX509CertificateRequestPkcs7-SchnittstelleInitializeDecode auf, indem Sie den Encoding-Parameter auf XCN_CRYPT_STRING_BINARY und den strEncodedData-Parameter auf einen der folgenden Werte festlegen:

Rufen Sie dann die InitializeDecode-Methode erneut mit dem codierten Zertifikatsatz im Argument strEncodedData auf.

Anforderungen

Siehe auch

IX509CertificateRequestPkcs7