Share via

ICertRequest3-Schnittstelle (certcli.h)

  • Artikel

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

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

  • Übermitteln Sie eine Zertifikatanforderung.
  • 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.
  • Rufen Sie den Ca-Eigenschaftswert, den Anzeigenamen und alle flags ab, die der Eigenschaft zugeordnet sind.
  • Rufen Sie die zwischengespeicherten Antwortdaten ab, die vom Server zurückgegeben werden.
  • Abrufen von Fehlermeldungstext für einen HRESULT-Fehlercode .

ICertRequest3 ist in Certcli.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Include-Datei. Certcli.dll stellt die ICertRequest3-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle befinden sich ebenfalls in Certcli.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 ICertRequest3-Schnittstelle erbt von ICertRequest2, ICertRequest und IDispatch. ICertRequest3 verfügt auch über folgende Membertypen:

Methoden

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

 
ICertRequest3::GetIssuedCertificate2

Ruft die Disposition eines Zertifikats ab, indem entweder die Anforderungs-ID-Zeichenfolge oder die Zertifikatsseriennummer angegeben wird.
ICertRequest3::GetRefreshPolicy

Gibt einen Wert zurück, der angibt, ob die zwischengespeicherte Zertifikatregistrierungsrichtlinie eines Clients veraltet ist und aktualisiert werden muss.
ICertRequest3::GetRequestIdString

Ruft die aktuelle interne Anforderungsnummer ab, die als Zeichenfolge formatiert ist, für die Anforderung und das nachfolgende Zertifikat.
ICertRequest3::SetCredential

Legt die Anmeldeinformationen fest, die zum Kontaktieren des Zertifikatregistrierungswebdiensts verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certcli.h (include Certsrv.h)

Weitere Informationen

ICertRequest

ICertRequest2

IDispatch