ICertRequest2::GetIssuedCertificate-Methode (certcli.h)

Artikel
08/22/2023

Die GetIssuedCertificate-Methode ruft die Disposition eines Zertifikats ab, indem entweder die Anforderungs-ID oder die Zertifikatsseriennummer angegeben wird.

Diese Methode ist praktisch identisch mit dem Aufrufen von ICertRequest3::RetrievePending, mit der zusätzlichen Funktion, eine Seriennummer für das betreffende Zertifikat anzugeben.

Syntax

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const BSTR strSerialNumber,
  [out, retval] LONG       *pDisposition
);

Parameter

[in] strConfig

Stellt eine gültige Konfigurationszeichenfolge für den Zertifikatdiensteserver dar. Die Zeichenfolge kann entweder eine HTTPS-URL für einen Registrierungsserver oder im Format ComputerName\CAName sein, wobei ComputerName der Netzwerkname des Servers und CAName der allgemeine Name der Zertifizierungsstelle ist, wie er während des Setups der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Eine HTTPS-URL wird nicht als Eingabe unterstützt.

[in] RequestId

Ein LONG-Wert , der die Zertifikatanforderungs-ID in der Certificates Services-Datenbank darstellt. Verwenden Sie -1 für diesen Wert, wenn die Seriennummer (als strSerialNumber übergeben) anstelle der Anforderungs-ID verwendet werden soll.

[in] strSerialNumber

Ein BSTR-Wert , der die von der Zertifizierungsstelle ausgestellte Zertifikatseriennummer darstellt. Damit strSerialNumber verwendet werden kann, müssen Sie für RequestId den Wert –1 angeben.

[out, retval] pDisposition

Ein Zeiger auf einen LONG-Wert , der die Disposition des Zertifikats darstellt. Die Disposition ist einer der folgenden Werte.

Wert	Bedeutung
CR_DISP_DENIED	Anforderung abgelehnt.
CR_DISP_ERROR	Anforderung fehlgeschlagen.
CR_DISP_INCOMPLETE	Die Anforderung wurde nicht abgeschlossen.
CR_DISP_ISSUED	Zertifikat ausgestellt.
CR_DISP_ISSUED_OUT_OF_BAND	Zertifikat separat ausgestellt.
CR_DISP_UNDER_SUBMISSION	Anforderung, die im Rahmen der Übermittlung übernommen wurde.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert ist ein Long-Wert , der die Disposition des Zertifikats darstellt.

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)
Bibliothek	Certidl.lib
DLL	Certcli.dll

Share via