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 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) |