Metodo ICertRequest::GetLastStatus (certcli.h)

Articolo
02/26/2024

Il metodo GetLastStatus ottiene l'ultimo codice restituito per questa richiesta. Restituisce le informazioni sul codice di errore anziché l'eliminazione della richiesta.

Sintassi

HRESULT GetLastStatus(
  [out] LONG *pStatus
);

Parametri

[out] pStatus

Puntatore al codice di stato della richiesta.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Al termine di questa funzione, *pStatus è impostato sul codice risultato della chiamata più recente a ICertRequest3::Submit, ICertRequest3::RetrievePending o ICertRequest3::GetCACertificate.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è il codice risultato della chiamata più recente a CCertRequest3.Submit, CCertRequest3.RetrievePending o CCertRequest3.GetCACertificate.

Commenti

Il valore recuperato da GetLastStatus dipende dalla chiamata più recente a ICertRequest3::Submit, ICertRequest3: :RetrievePending o ICertRequest3: :GetCACertificate. Se una chiamata a uno di questi metodi ha esito negativo nel server, chiamare GetLastStatus per recuperare il numero di errore. Alcuni errori del server (ad esempio richieste negate) restituiscono S_OK e un'eliminazione diversa da CR_DISP_ISSUED dalla chiamata al metodo e è possibile usare GetLastStatus per recuperare la causa specifica dell'errore. Se una chiamata a uno di questi metodi ha esito positivo, una chiamata successiva a GetLastStatus restituisce S_OK (ovvero zero).

Inoltre, l'eliminazione della richiesta viene archiviata nel database di Servizi certificati e può essere visualizzata tramite lo snap-in MMC dell'autorità di certificazione (scegliere la colonna Richiesta di eliminazione).

Esempio

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...
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certcli.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certcli.dll