IX509CertificateRequest-Schnittstelle (certenroll.h)
Die IX509CertificateRequest-Schnittstelle stellt eine abstrakte Basiszertifikatanforderung dar, die Methoden und Eigenschaften identifiziert, die für die einzelnen Anforderungsobjekte geerbt werden, die von der Zertifikatregistrierungs-API implementiert werden. In der folgenden Liste wird die Vererbungsstruktur dieser Objekte erläutert:
-
Eine PKCS #10-Zertifikatanforderung implementiert die Schnittstellen IX509CertificateRequest und IX509CertificateRequestPkcs10 .
-
Die PKCS #7-Zertifikatanforderung implementiert die Schnittstellen IX509CertificateRequest und IX509CertificateRequestPkcs7 .
Obwohl die PKCS #7-Spezifikation eine Syntax für sichere Nachrichten anstelle eines Typs der Zertifikatanforderung definiert, erfordert die Implementierung der IX509CertificateRequestPkcs7-Schnittstelle in diesem SDK, dass sie eine PKCS #10-Anforderung enthält. Daher bezieht sich diese Dokumentation auf ein PKCS #7-Objekt als Zertifikatanforderung.
-
Eine CMC-Zertifikatanforderung (Certificate Management Message over CMS) implementiert die Schnittstellen IX509CertificateRequest, IX509CertificateRequestPkcs7 und IX509CertificateRequestCmc .
-
Ein -Objekt, das verwendet werden kann, um ein selbst generiertes Zertifikat darzustellen (ein Zertifikat, das nicht von einer Zertifizierungsstelle ausgestellt wurde), implementiert die Schnittstellen IX509CertificateRequestRequestPkcs10 und IX509CertificateRequestCertificate.
Vererbung
Die IX509CertificateRequest-Schnittstelle erbt von der IDispatch-Schnittstelle . IX509CertificateRequest verfügt auch über folgende Membertypen:
Methoden
Die IX509CertificateRequest-Schnittstelle verfügt über diese Methoden.
| IX509CertificateRequest::Encode Signiert und codiert eine Zertifikatanforderung und erstellt ein Schlüsselpaar, falls keins vorhanden ist. |
| IX509CertificateRequest::get_AlternateSignatureAlgorithm Gibt einen booleschen Wert an, der angibt, ob der Signaturalgorithmus-Objektbezeichner (OID) für einen PKCS (Get) |
| IX509CertificateRequest::get_ClientId Gibt einen Wert an, der die ausführbare Datei identifiziert, die die Anforderung erstellt hat, und ruft diesen ab. (Abrufen) |
| IX509CertificateRequest::get_CspInformations Gibt eine Auflistung von Kryptografieanbietern an, die für die Verwendung durch das Anforderungsobjekt verfügbar sind, und ruft sie ab. (Abrufen) |
| IX509CertificateRequest::get_EnrollmentContext Ruft einen Wert ab, der angibt, ob das Zertifikat für einen Computer oder einen Benutzer vorgesehen ist. |
| IX509CertificateRequest::get_HashAlgorithm Gibt den Objektbezeichner (Object Identifier, OID) des Hashalgorithmus an, der zum Signieren der Zertifikatanforderung verwendet wird, und ruft diesen ab. (Abrufen) |
| IX509CertificateRequest::get_ParentWindow Gibt die ID des Fensters an, das von schlüsselbezogenen Benutzeroberflächendialogen verwendet wird, und ruft sie ab. (Abrufen) |
| IX509CertificateRequest::get_RawData Ruft ein Bytearray ab, das die signierte, Distinguished Encoding Rules(DER)-codierte Zertifikatanforderung enthält. |
| IX509CertificateRequest::get_RenewalCertificate Gibt ein Bytearray an oder ruft es ab, das das Distinguished Encoding Rules (DER) codierte Zertifikat enthält, das erneuert wird. (Abrufen) |
| IX509CertificateRequest::get_Silent Gibt einen booleschen Wert an, der angibt, ob während des Zertifikatregistrierungsprozesses eines der schlüsselbezogenen modalen Dialogfelder angezeigt wird, oder ruft diesen ab. (Abrufen) |
| IX509CertificateRequest::get_SuppressDefaults Gibt einen booleschen Wert an, der angibt, ob die Standarderweiterungen und -attribute in der Anforderung enthalten sind, oder ruft diesen ab. (Abrufen) |
| IX509CertificateRequest::get_Type Ruft einen Wert ab, der den Typ des Anforderungsobjekts angibt. |
| IX509CertificateRequest::get_UIContextMessage Gibt eine Kontextzeichenfolge an, die auf der Benutzeroberfläche angezeigt werden soll, oder ruft sie ab. (Abrufen) |
| IX509CertificateRequest::GetInnerRequest Ruft ein geschachteltes Anforderungsobjekt ab. |
| IX509CertificateRequest::Initialize Initialisiert das Anforderungsobjekt für einen Benutzer oder computer. |
| IX509CertificateRequest::p ut_AlternateSignatureAlgorithm Gibt einen booleschen Wert an, der angibt, ob der Signaturalgorithmus-Objektbezeichner (OID) für einen PKCS (Put) |
| IX509CertificateRequest::p ut_ClientId Gibt einen Wert an, der die ausführbare Datei identifiziert, die die Anforderung erstellt hat, und ruft diesen ab. (Put) |
| IX509CertificateRequest::p ut_CspInformations Gibt eine Auflistung von Kryptografieanbietern an, die für die Verwendung durch das Anforderungsobjekt verfügbar sind, und ruft sie ab. (Put) |
| IX509CertificateRequest::p ut_HashAlgorithm Gibt den Objektbezeichner (Object Identifier, OID) des Hashalgorithmus an, der zum Signieren der Zertifikatanforderung verwendet wird, und ruft diesen ab. (Put) |
| IX509CertificateRequest::p ut_ParentWindow Gibt die ID des Fensters an, das von schlüsselbezogenen Benutzeroberflächendialogen verwendet wird, und ruft sie ab. (Put) |
| IX509CertificateRequest::p ut_RenewalCertificate Gibt ein Bytearray an oder ruft es ab, das das Distinguished Encoding Rules (DER) codierte Zertifikat enthält, das erneuert wird. (Put) |
| IX509CertificateRequest::p ut_Silent Gibt einen booleschen Wert an, der angibt, ob während des Zertifikatregistrierungsprozesses eines der schlüsselbezogenen modalen Dialogfelder angezeigt wird, oder ruft diesen ab. (Put) |
| IX509CertificateRequest::p ut_SuppressDefaults Gibt einen booleschen Wert an, der angibt, ob die Standarderweiterungen und -attribute in der Anforderung enthalten sind, oder ruft diesen ab. (Put) |
| IX509CertificateRequest::p ut_UIContextMessage Gibt eine Kontextzeichenfolge an, die auf der Benutzeroberfläche angezeigt werden soll, oder ruft sie ab. (Put) |
| IX509CertificateRequest::ResetForEncode Stellt den Zustand des Anforderungsobjekts auf den Zustand zurück, der vor dem Aufruf der Encode-Methode vorhanden war. |
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 |