IX509Enrollment-Schnittstelle (certenroll.h)

Die IX509Enrollment-Schnittstelle stellt das Objekt der obersten Ebene dar und ermöglicht es Ihnen, sich in einer Zertifikathierarchie zu registrieren und eine Zertifikatantwort zu installieren. Der Registrierungsprozess unterstützt die folgenden drei Szenarien:

Out-of-Band-Registrierung

1. Rufen Sie eine beliebige Initialisierungsmethode auf, die vom IX509Enrollment-Objekt implementiert wird.
2. Rufen Sie die CreateRequest-Methode auf.
3. Senden Sie die Anforderung out-of-band (manuell oder über einen anderen Prozess).
4. Erhalten Sie die Antwort von einer Zertifizierungs- oder Registrierungsstelle.
5. Rufen Sie die InstallResponse-Methode auf .

Automatische Registrierung

1. Rufen Sie eine beliebige Initialisierungsmethode auf, die vom IX509Enrollment-Objekt implementiert wird.
2. Rufen Sie die Enroll-Methode auf.

Verzögerte Registrierung

1. Rufen Sie eine beliebige Initialisierungsmethode auf, die vom IX509Enrollment-Objekt implementiert wird.
2. Rufen Sie die CreateRequest-Methode auf.
3. Speichern Sie die Anforderung für einen bestimmten Zeitraum, z. B. Tage oder Wochen.
4. Rufen Sie die Initialize-Methode auf, um ein Anforderungsobjekt zu erstellen, wenn Sie zur Registrierung bereit sind.
5. Füllen Sie das Anforderungsobjekt aus Ihrer gespeicherten Anforderung auf.
6. Rufen Sie die InstallResponse-Methode auf .

Vererbung

Die IX509Enrollment-Schnittstelle erbt von der IDispatch-Schnittstelle . IX509Enrollment verfügt auch über folgende Membertypen:

Methoden

Die IX509Enrollment-Schnittstelle verfügt über diese Methoden.

IX509Enrollment::CreatePFX Erstellt eine PFX-Nachricht (Personal Information Exchange).
IX509Enrollment::CreateRequest Ruft eine codierte Zertifikatanforderung ab.
IX509Enrollment::Enroll Codiert eine Anforderung, übermittelt sie an eine entsprechende Zertifizierungsstelle (Ca) und installiert die Antwort.
IX509Registrierung::get_CAConfigString Ruft die Konfigurationszeichenfolge ab, die die Zertifizierungsstelle (CA) identifiziert, an die die Zertifikatanforderung gesendet wurde.
IX509Registrierung::get_Certificate Ruft das installierte Zertifikat ab.
IX509Registrierung::get_CertificateDescription Gibt eine Zeichenfolge an, die eine Beschreibung des Zertifikats enthält, oder ruft sie ab. (Get)
IX509Registrierung::get_CertificateFriendlyName Gibt den Anzeigenamen eines Zertifikats an oder ruft den Anzeigenamen ab. (Get)
IX509Registrierung::get_EnrollmentContext Ruft einen Registrierungskontext ab, der angibt, ob das Zertifikat für einen Computer oder einen Endbenutzer vorgesehen ist.
IX509Registrierung::get_NameValuePairs Ruft eine Auflistung von Name-Wert-Paaren ab, die dem Registrierungsobjekt zugeordnet sind.
IX509Registrierung::get_ParentWindow Gibt die ID des Fensters an, das zum Anzeigen der Registrierungsinformationen verwendet wird, oder ruft sie ab. (Get)
IX509Registrierung::get_Request Ruft die Zertifikatanforderung ab, die dem Registrierungsobjekt zugeordnet ist.
IX509Registrierung::get_RequestId Ruft einen eindeutigen Bezeichner für die Zertifikatanforderung ab, die mit der Enroll-Methode an die Zertifizierungsstelle gesendet wird.
IX509Registrierung::get_Response Ruft die von einer Zertifizierungsstelle zurückgegebene Zertifikatantwort ab.
IX509Registrierung::get_Silent Gibt einen booleschen Wert an, der angibt, ob während des Zertifikatregistrierungsprozesses eine Benutzeroberfläche angezeigt wird, oder ruft diesen ab. (Get)
IX509Registrierung::get_Status Ruft ein IX509EnrollmentStatus-Objekt ab, das verwendet werden kann, um die status des Registrierungsprozesses zu überwachen und Fehlerinformationen abzurufen.
IX509Enrollment::Initialize Initialisiert das Registrierungsobjekt und erstellt einen Standard-PKCS.
IX509Enrollment::InitializeFromRequest Initialisiert das Registrierungsobjekt aus einem vorhandenen IX509CertificateRequest-Objekt.
IX509Enrollment::InitializeFromTemplateName Initialisiert das Registrierungsobjekt aus einem Vorlagennamen (Common Name, CN).
IX509Enrollment::InstallResponse Installiert eine Zertifikatkette auf dem Endentitätscomputer. (IX509Enrollment.InstallResponse)
IX509Enrollment::p ut_CertificateDescription Gibt eine Zeichenfolge an, die eine Beschreibung des Zertifikats enthält, oder ruft sie ab. (Put)
IX509Enrollment::p ut_CertificateFriendlyName Gibt den Anzeigenamen eines Zertifikats an oder ruft den Anzeigenamen ab. (Put)
IX509Enrollment::p ut_ParentWindow Gibt die ID des Fensters an, das zum Anzeigen der Registrierungsinformationen verwendet wird, oder ruft sie ab. (Put)
IX509Enrollment::p ut_Silent Gibt einen booleschen Wert an, der angibt, ob während des Zertifikatregistrierungsprozesses eine Benutzeroberfläche angezeigt wird, oder ruft diesen ab. (Put)

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h

Weitere Informationen

Certificate Enrollment API (Zertifikatregistrierungs-API, in englischer Sprache)

IDispatch

IX509EnrollmentStatus