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
);
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 |
|---|---|
|
Das Anforderungsobjekt, das an den pInnerRequest-Parameter übergeben wird, muss ein PKCS #10 oder eine CMC-Anforderung 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 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 |