IX509CertificateRequestCmc::InitializeFromInnerRequestTemplateName-Methode (certenroll.h)

Die InitializeFromInnerRequestTemplateName-Methode initialisiert die Zertifikatanforderung von einem inneren Anforderungsobjekt und einer Vorlage.

Syntax

HRESULT InitializeFromInnerRequestTemplateName(
  [in] IX509CertificateRequest *pInnerRequest,
  [in] BSTR                    strTemplateName
);

Die Parameter

[in] pInnerRequest

Zeiger auf eine IX509CertificateRequest-Schnittstelle , die das innere Anforderungsobjekt darstellt. Dies kann eine PKCS #10- oder CMC-Anforderung sein.

[in] strTemplateName

Eine BSTR-Variable , die den allgemeinen Namen (Common Name, CN) der Vorlage enthält, wie sie in Active Directory oder dem bezeichner des gepunkteten Dezimalobjekts angezeigt wird.

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

Durch Angeben einer Vorlage können Sie dem äußeren Anforderungsobjekt Informationen hinzufügen, die möglicherweise nicht in der inneren Anforderung enthalten sind. Wenn die innere Anforderung z. B. nicht die erforderlichen Erweiterungen enthält, können Sie eine Vorlage bereitstellen, die dies tut.

Die InitializeFromInnerRequestTemplateName-Methode :

• Erstellt eine leere ICryptAttributes -Auflistung.
• Erstellt eine leere IX509NameValuePairs -Auflistung.
• Erstellt eine leere IX509Extensions -Auflistung.
• Erstellt eine IObjectIds -Auflistung für kritische Erweiterungen und fügt die XCN_OID_KEY_USAGE und XCN_OID_BASIC_CONSTRAINTS2 Objektbezeichner (OIDs) hinzu.
• Erstellt eine leere IObjectIds -Auflistung von OIDs, die vom Anforderungsobjekt unterdrückt werden sollen.
• Erstellt eine leere ISignerCertificates - Auflistung.
• Ruft private Schlüsselkennzeichnungen aus der Vorlage ab.
• Legt die ArchivePrivateKey-Eigenschaft fest, wenn dies durch die Vorlagenkennzeichnungen oder -einstellungen erforderlich ist.
• Ruft den Verschlüsselungsalgorithmus aus der Vorlage ab, wenn eine angegeben ist, und legt die EncryptionAlgorithm -Eigenschaft fest.
• Legt die EncryptionStrength-Eigenschaft fest, falls möglich.

Anforderungen

Siehe auch

IX509CertificateRequestCmc