Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis 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) |