ICertRequest-Schnittstelle (certcli.h)

  • Artikel

Die ICertRequest-Schnittstelle ermöglicht die Kommunikation zwischen einem Client oder einer zwischengeschalteten Anwendung und Zertifikatdiensten.

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

  • Zertifikatanforderung übermitteln.
  • Rufen Sie die Disposition, den letzten status und den Bezeichner einer Anforderung ab.
  • Rufen Sie das für die Anforderung ausgestellte Zertifikat ab.
  • Ruft ausstehende Zertifikate für frühere Anforderungen ab.
  • Rufen Sie das Zertifizierungsstelle-Zertifikat für den Certificate Services-Server ab.

ICertRequest ist in Certcli.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Include-Datei. Certcli.dll stellt die ICertRequest-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle befinden sich ebenfalls in Certclil.dll, das mit dem Platform Software Development Kit (SDK) ausgeliefert wird.

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

Vererbung

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

Methoden

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

 
ICertRequest::GetCACertificate

Gibt das Zertifikat der Zertifizierungsstelle (Ca) für den Zertifikatdiensteserver zurück.
ICertRequest::GetCertificate

Gibt das für die Anforderung ausgestellte Zertifikat als X.509-Zertifikat zurück oder optional in einem Public Key Cryptography Standards (PKCS) gepackt.
ICertRequest::GetDispositionMessage

Ruft eine lesbare Nachricht ab, die die aktuelle Disposition der Zertifikatanforderung angibt.
ICertRequest::GetLastStatus

Ruft den letzten Rückgabecode für diese Anforderung ab. Dadurch werden die Fehlercodeinformationen und nicht die Disposition der Anforderung zurückgegeben.
ICertRequest::GetRequestId

Ruft die aktuelle interne Anforderungsnummer für die Anforderung und das nachfolgende Zertifikat ab.
ICertRequest::RetrievePending

Ruft die Disposition eines Zertifikats status aus einer früheren Anforderung ab, die möglicherweise zuvor CR_DISP_INCOMPLETE oder CR_DISP_UNDER_SUBMISSION zurückgegeben hat.
ICertRequest::Submit

Sendet eine Anforderung an den Certificate Services-Server.

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 (include Certsrv.h)