Freigeben über

ICertRequest2::GetIssuedCertificate-Methode (certcli.h)

  • Artikel

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