Freigeben über


ICspStatus-Schnittstelle (certenroll.h)

Ein ICspStatus-Objekt enthält Informationen zu einem Kryptografieanbieter/Algorithmus-Paar. Das -Objekt wird in erster Linie vom Zertifikatregistrierungssteuerelement verwendet, damit ein Benutzer auswählen kann, welche Kryptografieanbieter und Algorithmen beim Erstellen einer Zertifikatanforderung verwendet werden sollen. Sie kann entweder allein oder in einer ICspStatuses-Auflistung abgerufen werden, indem Sie die folgenden Eigenschaften oder Methoden aufrufen:

Eigenschaft/Methode Schnittstelle BESCHREIBUNG
GetCspStatusFromOperations ICspInformation Erstellt ein ICspStatus-Objekt für den ersten unterstützten Algorithmus, der mit einem angegebenen Algorithmusobjektbezeichner (OID) und algorithmustyp konsistent ist.
GetCspStatusesFromOperations ICspInformations Erstellt eine ICspStatuses-Auflistung für einen angegebenen Algorithmustyp und optionale Anbieterinformationen.
Hinweis Das Zertifikatregistrierungssteuerelement verwendet eine ICspStatuses-Auflistung nur für die asymmetrische Algorithmusauswahl für private Schlüssel (Verschlüsselung, Signatur und Schlüsselaustausch).
 
GetCspStatusFromProviderName ICspInformations Erstellt ein ICspStatus-Objekt für einen Legacyanbieter nach Anbietername und unterstützten Schlüsselvorgängen.
CspStatus IX509PrivateKey Gibt ein ICspStatus-Objekt an oder ruft es ab. Das Objekt wird in der Regel während des Registrierungsprozesses erstellt.
GetCspStatuses IX509CertificateRequestPkcs10 Erstellt eine ICspStatuses-Auflistung , die alle Anbieter-Algorithmus-Paare enthält, die mit der beabsichtigten Verwendung des privaten Schlüssels übereinstimmen, wie vom Aufrufer angegeben.
CspStatuses IX509CertificateRequestPkcs10 Erstellt eine ICspStatuses-Auflistung , die alle Anbieter/Algorithmus-Paare enthält, die mit der beabsichtigten Verwendung des privaten Schlüssels übereinstimmen, die durch das IX509PrivateKey-Objekt identifiziert werden, das der Zertifikatanforderung zugeordnet ist.
 

Da Kryptografieanbieter in der Regel mehr als einen Algorithmus unterstützen, können mehrere ICspStatus-Objekte erstellt und zurückgegeben werden, wenn Sie eine der vorherigen Eigenschaften oder Methoden aufrufen, die eine Auflistung zurückgeben. Dies wird in der folgenden Abbildung gezeigt:

Struktur der ICspStatuses-Auflistung mit einzelnen ICspStatus-Objekten

Sie können die EnrollmentStatus-Eigenschaft für ein ICspStatus-Objekt verwenden, um ein IX509EnrollmentStatus-Objekt abzurufen, das die folgenden Eigenschaften definiert:

  • Die Display-Eigenschaft gibt an, ob das Anbieter-Algorithmus-Paar in einer Benutzeroberfläche angezeigt werden kann.
  • Die Selected-Eigenschaft gibt einen Wert an, der angibt, ob die status eines bestimmten Elements während des Registrierungsprozesses überwacht wird.
  • Die Status-Eigenschaft identifiziert die status des Registrierungsprozesses.

Vererbung

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

Methoden

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

 
ICspStatus::get_CspAlgorithm

Ruft ein ICspAlgorithm-Objekt ab, das Informationen zu einem vom Anbieter unterstützten Algorithmus enthält.
ICspStatus::get_CspInformation

Ruft ein ICspInformation-Objekt ab, das allgemeine Informationen zum Anbieter enthält.
ICspStatus::get_DisplayName

Ruft eine Zeichenfolge ab, die den Namen des Anbieters, den Algorithmusnamen und die Vorgänge enthält, die vom Algorithmus ausgeführt werden können.
ICspStatus::get_EnrollmentStatus

Ruft ein IX509EnrollmentStatus-Objekt ab, das Informationen zur Zertifikatregistrierung enthält.
ICspStatus::get_Ordinal

Gibt die Position des ICspStatus-Objekts in der ICspStatuses-Auflistung an oder ruft sie ab. (Abrufen)
ICspStatus::Initialize

Initialisiert das Objekt von einem Kryptografieanbieter und einem zugeordneten Algorithmus.
ICspStatus::p ut_Ordinal

Gibt die Position des ICspStatus-Objekts in der ICspStatuses-Auflistung an oder ruft sie ab. (Put)

Anforderungen

Anforderung Wert
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

CertEnroll-Schnittstellen

ICspStatuses

IDispatch