ICertRequest2-Schnittstelle (certcli.h)

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

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

• Senden Sie die Zertifikatanforderung.
• Rufen Sie die Disposition, die letzte status und den Bezeichner einer Anforderung ab.
• Rufen Sie das für die Anforderung ausgestellte Zertifikat ab.
• Abrufen ausstehender Zertifikate für vorherige Anforderungen.
• Rufen Sie das Zertifizierungsstellenzertifikat für den Zertifikatdiensteserver ab.
• Rufen Sie den Wert der Ca-Eigenschaft, den Anzeigenamen und alle flags ab, die der Eigenschaft zugeordnet sind.
• Rufen Sie die vom Server zurückgegebenen zwischengespeicherten Antwortdaten ab.
• Abrufen des Fehlermeldungstexts für einen HRESULT-Fehlercode .

ICertRequest2 ist in Certcli.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Includedatei. Certcli.dll stellt die ICertRequest2-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle finden Sie auch in Certclil.dll, das im Lieferumfang des Platform Software Development Kit (SDK) enthalten ist.

Zertifikatdienstschnittstellen unterstützen sowohl Apartmentthreading- als auch Free-Threading-Modelle. Für einen besseren Durchsatz wird freies Threading empfohlen.

Vererbung

Die ICertRequest2-Schnittstelle erbt von ICertRequest und IDispatch. ICertRequest2 verfügt auch über folgende Membertypen:

Methoden

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

ICertRequest2::GetCAProperty Ruft einen Eigenschaftswert für die Zertifizierungsstelle (Ca) ab. (ICertRequest2.GetCAProperty)
ICertRequest2::GetCAPropertyDisplayName Ruft den Anzeigenamen der Eigenschaft für eine Zertifizierungsstelle -Eigenschaft (CA) ab.
ICertRequest2::GetCAPropertyFlags Ruft die Eigenschaftsflags für eine Zertifizierungsstelle -Eigenschaft (CA) ab.
ICertRequest2::GetErrorMessageText Ruft den Fehlermeldungstext für einen HRESULT-Fehlercode ab.
ICertRequest2::GetFullResponseProperty Ruft die vom Server zurückgegebenen zwischengespeicherten Antwortdaten ab.
ICertRequest2::GetIssuedCertificate Ruft die Disposition eines Zertifikats ab, indem entweder die Anforderungs-ID oder die Seriennummer des Zertifikats angegeben wird.

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 (certsrv.h einschließen)