ICertRequest3-Schnittstelle (certcli.h)
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) |