ICertRequest::GetLastStatus-Methode (certcli.h)

Artikel
08/22/2023

Die GetLastStatus-Methode ruft den letzten Rückgabecode für diese Anforderung ab. Dadurch werden die Fehlercodeinformationen und nicht die Disposition der Anforderung zurückgegeben.

Syntax

HRESULT GetLastStatus(
  [out] LONG *pStatus
);

Parameter

[out] pStatus

Ein Zeiger auf den status Code der Anforderung.

Rückgabewert

C++

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

Nach erfolgreichem Abschluss dieser Funktion wird *pStatus auf den Ergebniscode des letzten Aufrufs von ICertRequest3::Submit, ICertRequest3::RetrievePending oder ICertRequest3::GetCACertificate festgelegt.

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 der Ergebniscode des letzten Aufrufs von CCertRequest3.Submit, CCertRequest3.RetrievePending oder CCertRequest3.GetCACertificate.

Hinweise

Der von GetLastStatus abgerufene Wert hängt vom letzten Aufruf von ICertRequest3::Submit, ICertRequest3::RetrievePending oder ICertRequest3::GetCACertificate ab. Wenn ein Aufruf einer dieser Methoden auf dem Server fehlschlägt, rufen Sie GetLastStatus auf, um die Fehlernummer abzurufen. Einige Serverfehler (z. B. verweigerte Anforderungen) geben S_OK und eine andere Disposition als CR_DISP_ISSUED aus dem Methodenaufruf zurück, und Sie können GetLastStatus verwenden, um die spezifische Fehlerursache abzurufen. Wenn ein Aufruf einer dieser Methoden erfolgreich ist, gibt ein späterer Aufruf von GetLastStatus S_OK (null) zurück.

Darüber hinaus wird die Anforderungsdisposition in der Zertifikatdienste-Datenbank gespeichert und kann mithilfe des MMC-Snap-Ins zertifizierungsstelle (Wählen Sie die Spalte Disposition anfordern) angezeigt werden.

Beispiele

HRESULT    hrServer, hr;
// pCertRequest is previously instantiated
// ICertRequest object pointer.
hr = pCertRequest->GetLastStatus((LONG *) &hrServer);
if (FAILED(hr))
{
    printf("Failed GetLastStatus [%x]\n", hr);
    goto error;
}
else
{
    // Use the HRESULT value as needed...
}

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