Metodo ICertRequest::GetLastStatus (certcli.h)
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 |