IX509CertificateRequestCmc2::InitializeFromInnerRequestTemplate-Methode (certenroll.h)

Artikel
03/01/2024

Die InitializeFromInnerRequestTemplate-Methode initialisiert die Zertifikatanforderung aus einem internen Anforderungsobjekt und einer Vorlage.

Syntax

HRESULT InitializeFromInnerRequestTemplate(
  [in] IX509CertificateRequest     *pInnerRequest,
  [in] IX509EnrollmentPolicyServer *pPolicyServer,
  [in] IX509CertificateTemplate    *pTemplate
);

Parameter

[in] pInnerRequest

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

[in] pPolicyServer

Zeiger auf ein IX509EnrollmentPolicyServer-Objekt , das den Zertifikatregistrierungsrichtlinienserver (Certificate Enrollment Policy, CEP) darstellt, der die vom pTemplate-Parameter angegebene Vorlage enthält.

[in] pTemplate

Zeiger auf ein IX509CertificateTemplate-Objekt , das die Vorlage darstellt, die während der Initialisierung verwendet werden soll.

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ö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 eine PKCS #10- oder CMC-Anforderung sein.
E_POINTER	Die Parameter pInnerRequest, pPolicyServer und pTemplate können nicht NULL 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 angeben, die dies tut.

Die InitializeFromInnerRequestTemplate-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 Flags für private Schlüssel aus der Vorlage ab.
Legt die ArchivePrivateKey-Eigenschaft fest, wenn dies für die Vorlagenflags oder -einstellungen erforderlich ist.
Ruft den Verschlüsselungsalgorithmus aus der Vorlage ab, sofern angegeben, und legt die EncryptionAlgorithm-Eigenschaft fest .
Legt die EncryptionStrength-Eigenschaft nach Möglichkeit fest.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h

Weitere Informationen

IX509CertificateRequestCmc2

Freigeben über