ICertRequest::GetLastStatus-Methode (certcli.h)

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++

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

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

Weitere Informationen

CCertRequest

ICertRequest

ICertRequest2

ICertRequest3