IX509Enrollment::InitializeFromTemplateName-Methode (certenroll.h)
Die InitializeFromTemplateName-Methode initialisiert das Registrierungsobjekt aus einem Vorlagen common name (CN).
Syntax
HRESULT InitializeFromTemplateName(
[in] X509CertificateEnrollmentContext Context,
[in] BSTR strTemplateName
);
Parameter
[in] Context
Ein X509CertificateEnrollmentContext-Enumerationswert , der angibt, ob die angeforderte Registrierung für einen Benutzer, einen Computer oder einen Administrator gilt, der im Auftrag eines Computers handelt.
[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 Registrierungsobjekt wurde bereits initialisiert. |
Hinweise
Die InitializeFromTemplateName-Methode :
- Untersucht die Vorlage, um den Typ der erforderlichen Anforderung zu ermitteln.
- Erstellt den entsprechenden Typ des Anforderungsobjekts (PKCS #10, PKCS #7 oder CMC).
- Legt die folgenden Eigenschaften für die Anforderung fest, wenn derzeit Werte vorhanden sind:
- Initialisiert das Anforderungsobjekt mithilfe der Vorlage.
- Ruft die Signaturanzahl, Ausstellungsrichtlinien und Anwendungsrichtlinien aus der Vorlage ab.
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 |