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 . Vererbungsdiagramm für ein PKCS #10-Anforderungsobjekt
  • Die PKCS #7-Zertifikatanforderung implementiert die Schnittstellen IX509CertificateRequest und IX509CertificateRequestPkcs7 . Vererbungsdiagramm für ein PKCS #7-Anforderungsobjekt

    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 . Vererbungsdiagramm für ein CMC-Anforderungsobjekt
  • 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. Vererbungsdiagramm für ein selbst generiertes Zertifikat

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

Weitere Informationen

CertEnroll-Schnittstellen

IDispatch

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7