Freigeben über


IX509Enrollment::InitializeFromTemplateName-Methode (certenroll.h)

Die InitializeFromTemplateName-Methode initialisiert das Registrierungsobjekt aus einem gemeinsamen Vorlagennamen (CN).

Syntax

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

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.

[in] strTemplateName

Eine BSTR-Variable , die den allgemeinen Namen (Common Name, CN) der Vorlage enthält, wie sie in Active Directory oder dem bezeichner des gepunkteten Dezimalobjekts angezeigt wird.

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
Das Registrierungsobjekt wurde bereits initialisiert.

Bemerkungen

Die InitializeFromTemplateName-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 Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header certenroll.h
DLL CertEnroll.dll

Siehe auch

IX509Enrollment