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:
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 |