ICertRequest3::GetIssuedCertificate2-Methode (certcli.h)

Artikel
02/23/2024

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

Syntax

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          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] strRequestId

Ein BSTR-Wert , der die Zertifikatanforderungs-ID in der Certificates Services-Datenbank darstellt. Legen Sie diesen Parameter auf NULL fest, wenn die Seriennummer (als strSerialNumber übergeben) anstelle der Anforderungs-ID verwendet werden soll.

Verwenden Sie die ICertRequest3::GetRequestIdString-Methode , um die Anforderungs-ID-Zeichenfolge abzurufen.

[in] strSerialNumber

Ein BSTR-Wert , der die von der Zertifizierungsstelle ausgestellte Zertifikatseriennummer darstellt. Die Zeichenfolge muss die Seriennummer als gerade Zahl von Hexadezimalstellen angeben. Bei Bedarf kann eine Null der Zahl vorangestellt werden, um eine gerade Anzahl von Ziffern zu erzeugen. Es darf jedoch nicht mehr als eine führende Null verwendet werden.

Der strSerialNumber-Wert wird nur verwendet, wenn strRequestId auf NULL festgelegt ist.

[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 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certcli.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certcli.dll

Weitere Informationen

CCertRequest

ICertRequest3

Freigeben über