IX509CertificateRequestCmc2::InitializeFromInnerRequestTemplate-Methode (certenroll.h)
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 |
|---|---|
|
Das anforderungsobjekt, das an den pInnerRequest-Parameter übergeben wird, muss eine PKCS #10- oder CMC-Anforderung sein. |
|
Die Parameter pInnerRequest, pPolicyServer und pTemplate können nicht NULL sein. |
|
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 |