Freigeben über

IX509Enrollment2::InitializeFromTemplate-Methode (certenroll.h)

Die InitializeFromTemplate-Methode initialisiert das Registrierungsobjekt mithilfe einer Vorlage.

Syntax

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Die Parameter

[in] context

Ein X509CertificateEnrollmentContext-Enumerationswert , der angibt, ob die angeforderte Registrierung für einen Benutzer, einen Computer oder einen Administrator im Auftrag eines Computers erfolgt. Dies kann einer der folgenden Werte sein:

Wert Bedeutung
ContextUser
 Das Zertifikat wird für einen Endbenutzer angefordert.
ContextMachine
 Das Zertifikat wird für einen Computer angefordert.
ContextAdministratorForceMachine
 Das Zertifikat wird von einem Administrator angefordert, der im Namen eines Computers handelt.

[in] pPolicyServer

Zeiger auf ein IX509EnrollmentPolicyServer -Objekt, das den Zertifikatregistrierungsrichtlinienserver (CEP) darstellt, der die durch den 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Zurückgeben von Code/Wert Description
E_POINTER
 Die Parameter "pPolicyServer " und "pTemplate " dürfen nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Das Registrierungsobjekt wurde bereits initialisiert.

Bemerkungen

Die InitializeFromTemplate-Methode :

  • Überprüft die Vorlage, um den erforderlichen Anforderungstyp zu ermitteln.
  • Erstellt den entsprechenden Anforderungsobjekttyp (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
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header certenroll.h

Siehe auch

IX509Enrollment2

  • Last updated on