IX509CertificateRequestPkcs10::InitializeFromCertificate-Methode (certenroll.h)

Die InitializeFromCertificate-Methode initialisiert die Zertifikatanforderung mithilfe eines vorhandenen Zertifikats. Das Zertifikat ist in einem Bytearray enthalten, das mithilfe von Distinguished Encoding Rules (DER) codiert wird, wie durch den Standard "Abstrakte Syntax Notation One (ASN.1)" definiert. Das DER-codierte Bytearray wird durch eine Zeichenfolge dargestellt, die entweder eine reine binäre Sequenz ist oder Unicode-codiert ist.

Syntax

HRESULT InitializeFromCertificate(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strCertificate,
  [in] EncodingType                     Encoding,
  [in] X509RequestInheritOptions        InheritOptions
);

Die Parameter

[in] Context

Ein X509CertificateEnrollmentContext-Enumerationswert , der angibt, ob das angeforderte Zertifikat für einen Endbenutzer, einen Computer oder einen Administrator bestimmt ist, der im Namen des Computers handelt.

[in] strCertificate

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

Ab Windows 7 und Windows Server 2008 R2 können Sie einen Zertifikatfingerabdruck oder eine Seriennummer anstelle eines codierten Zertifikats angeben. Dies bewirkt, dass die Funktion die entsprechenden lokalen Speicher nach dem übereinstimmenden Zertifikat durchsucht. Berücksichtigen Sie dabei Folgendes:

• Der BSTR muss eine gerade Anzahl hexadezimaler Ziffern sein.
• Leerzeichen zwischen hexadezimalen Paaren werden ignoriert.
• Der Codierungsparameter muss auf XCN_CRYPT_STRING_HEXRAW festgelegt werden.
• Der Context-Parameter bestimmt, ob der Benutzer oder der Computer speichert oder beides durchsucht werden.
• Wenn ein privater Schlüssel benötigt wird, werden nur die persönlichen Speicher und Anforderungsspeicher durchsucht.
• Wenn kein privater Schlüssel benötigt wird, werden auch die Stamm- und Zwischenspeicher der Zertifizierungsstelle durchsucht.

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf das DER-codierte Zertifikat angewendet wird. Der Standardwert ist XCN_CRYPT_STRING_BASE64.

[in] InheritOptions

Ein X509RequestInheritOptions-Enumerationswert , der angibt, wie das Zertifikatanforderungsobjekt aus dem vorhandenen Zertifikat erstellt wird. Sie können angeben, wie ein Schlüssel geerbt werden soll, indem Sie einen der folgenden Werte auswählen. Der Standardwert ist InheritDefault.

Sie können auch einen bitweise OR-Vorgang verwenden, um den Schlüsselvererbungswert mit einer beliebigen Kombination der folgenden Werte zu kombinieren.

Sie können "InheritNone" auch angeben, um zu verhindern, dass alle Flags in der vorherigen Tabelle (Flags, die nicht mit der Schlüsselvererbung zusammenhängen) standardmäßig implementiert werden. Wenn Sie InheritNone angeben, aber auch ein Flag angeben, das nicht mit der Schlüsselvererbung verknüpft ist, gibt die Methode E_INVALIDARG zurück.

Wenn Sie den Parameter InheritOptions auf Null (0) festlegen oder "InheritDefault " angeben und keinen Schlüsselvererbungswert angeben, wird InheritNewSimilarKey standardmäßig verwendet.

Wenn Sie den Parameter InheritOptions auf Null (0) festlegen oder InheritDefault angeben und keine Werte angeben, die nicht mit der Schlüsselvererbung zusammenhängen, werden die folgenden Flags standardmäßig festgelegt:

• InheritSubjectFlag
• InheritExtensionsFlag
• InheritValidityPeriodFlag
• InheritTemplateFlag (wenn das Zertifikat eine Vorlagenerweiterung 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

Die InitializeFromCertificate-Methode überprüft die im Parameter InheritOptions angegebenen Optionen und initialisiert ein neues PKCS #10-Anforderungsobjekt, indem die folgenden Aktionen ausgeführt werden:

• Kopiert das Erneuerungszertifikat, sofern vorhanden und Sie "InheritRenewalCertificateFlag" angegeben haben, vom Eingabezertifikat in die neue Anforderung.
• Kopiert die Vorlage, wenn eine im vorhandenen Zertifikat angegeben ist, und Legen Sie den InheritTemplateFlag-Wert fest.
• Kopiert den Namen des Betreffs in die neue Anforderung, wenn Sie InheritSubjectFlag angeben.
• Kopiert den alternativen Antragstellernamen in die neue Anforderung, wenn Sie InheritSubjectAltNameFlag angeben.
• Kopiert die Erweiterungen in die neue Anforderung, wenn Sie InheritExtensionsFlag angeben.

Anforderungen

Siehe auch

IX509CertificateRequestPkcs10