IX509CertificateRequestCmc::InitializeFromInnerRequestTemplateName-Methode (certenroll.h)

Artikel
08/22/2023

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

Syntax

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

Parameter

[in] pInnerRequest

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

[in] strTemplateName

Eine BSTR-Variable , die den allgemeinen Namen (Common Name, CN) der Vorlage enthält, wie er in Active Directory angezeigt wird, oder den dezimalen Objektbezeichner mit Punkt.

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
CRYPT_E_INVALID_MSG_TYPE	Das Anforderungsobjekt, das an den pInnerRequest-Parameter übergeben wird, muss ein PKCS #10 oder eine CMC-Anforderung sein.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Anforderungsobjekt wurde bereits initialisiert.

Hinweise

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 beispielsweise 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 aus dem Anforderungsobjekt unterdrückt werden sollen.
Erstellt eine leere ISignerCertificates-Auflistung .
Ruft private Schlüsselflags aus der Vorlage ab.
Legt die ArchivePrivateKey-Eigenschaft fest, wenn dies durch die Vorlagenflags oder -einstellungen erforderlich ist.
Ruft den Verschlüsselungsalgorithmus aus der Vorlage ab, sofern einer angegeben ist, und legt die EncryptionAlgorithm-Eigenschaft fest.
Legt die EncryptionStrength-Eigenschaft nach Möglichkeit fest.

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

Weitere Informationen

IX509CertificateRequestCmc