Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
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) |