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