Freigeben über

IX509Enrollment2::InitializeFromTemplate-Methode (certenroll.h)

  • Artikel

Die InitializeFromTemplate-Methode initialisiert das Registrierungsobjekt mithilfe einer Vorlage.

Syntax

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

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. 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 (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
E_POINTER
 Die Parameter pPolicyServer und pTemplate können nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Das Registrierungsobjekt wurde bereits initialisiert.

Hinweise

Die InitializeFromTemplate-Methode :

  • Untersucht die Vorlage, um den erforderlichen Anforderungstyp zu ermitteln.
  • Erstellt den geeigneten 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 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certenroll.h

Weitere Informationen

IX509Registrierung2