Freigeben über

IX509Enrollment-Schnittstelle (certenroll.h)

  • Artikel

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