Freigeben über

ICertRequest2-Schnittstelle (certcli.h)

  • Artikel

Die ICertRequest2-Schnittstelle ist eine von zwei Schnittstellen, die die Kommunikation zwischen einem Client oder einer zwischengeschalteten Anwendung und Zertifikatdiensten bereitstellen.

Client- und Zwischenanwendungen können die ICertRequest2-Methoden aufrufen, um die folgenden Aufgaben auszuführen:

  • Senden Sie die Zertifikatanforderung.
  • Rufen Sie die Disposition, die letzte status und den Bezeichner einer Anforderung ab.
  • Rufen Sie das für die Anforderung ausgestellte Zertifikat ab.
  • Abrufen ausstehender Zertifikate für vorherige Anforderungen.
  • Rufen Sie das Zertifizierungsstellenzertifikat für den Zertifikatdiensteserver ab.
  • Rufen Sie den Wert der Ca-Eigenschaft, den Anzeigenamen und alle flags ab, die der Eigenschaft zugeordnet sind.
  • Rufen Sie die vom Server zurückgegebenen zwischengespeicherten Antwortdaten ab.
  • Abrufen des Fehlermeldungstexts für einen HRESULT-Fehlercode .

ICertRequest2 ist in Certcli.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Includedatei. Certcli.dll stellt die ICertRequest2-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle finden Sie auch in Certclil.dll, das im Lieferumfang des Platform Software Development Kit (SDK) enthalten ist.

Zertifikatdienstschnittstellen unterstützen sowohl Apartmentthreading- als auch Free-Threading-Modelle. Für einen besseren Durchsatz wird freies Threading empfohlen.

Vererbung

Die ICertRequest2-Schnittstelle erbt von ICertRequest und IDispatch. ICertRequest2 verfügt auch über folgende Membertypen:

Methoden

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

 
ICertRequest2::GetCAProperty

Ruft einen Eigenschaftswert für die Zertifizierungsstelle (Ca) ab. (ICertRequest2.GetCAProperty)
ICertRequest2::GetCAPropertyDisplayName

Ruft den Anzeigenamen der Eigenschaft für eine Zertifizierungsstelle -Eigenschaft (CA) ab.
ICertRequest2::GetCAPropertyFlags

Ruft die Eigenschaftsflags für eine Zertifizierungsstelle -Eigenschaft (CA) ab.
ICertRequest2::GetErrorMessageText

Ruft den Fehlermeldungstext für einen HRESULT-Fehlercode ab.
ICertRequest2::GetFullResponseProperty

Ruft die vom Server zurückgegebenen zwischengespeicherten Antwortdaten ab.
ICertRequest2::GetIssuedCertificate

Ruft die Disposition eines Zertifikats ab, indem entweder die Anforderungs-ID oder die Seriennummer des Zertifikats angegeben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certcli.h (certsrv.h einschließen)