Metodo ICertRequest::RetrievePending (certcli.h)

Articolo
02/23/2024

Il metodo RetrievePending recupera lo stato di eliminazione di un certificato da una richiesta precedente che potrebbe essere stata restituita in precedenza CR_DISP_INCOMPLETE o CR_DISP_UNDER_SUBMISSION.

Se lo stato di eliminazione risultante è CR_DISP_ISSUED, è possibile recuperare il certificato rilasciato chiamando ICertRequest3::GetCertificate. Se viene restituita un'eliminazione diversa da CR_DISP_ISSUED, chiamare ICertRequest3::GetLastStatus, ICertRequest3::GetDispositionMessage o entrambi i metodi per altre informazioni.

Sintassi

HRESULT RetrievePending(
  [in]          LONG       RequestId,
  [in]          const BSTR strConfig,
  [out, retval] LONG       *pDisposition
);

Parametri

[in] RequestId

ID della richiesta restituita in precedenza CR_DISP_INCOMPLETE o CR_DISP_UNDER_SUBMISSION.

[in] strConfig

Rappresenta una stringa di configurazione valida per il server Servizi certificati. La stringa può essere un URL HTTPS per un server di registrazione o nel formato ComputerName\CAName, dove ComputerName è il nome di rete del server e CAName è il nome comune dell'autorità di certificazione, come immesso durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Un URL HTTPS non è supportato come input.

[out, retval] pDisposition

Puntatore al valore di eliminazione della richiesta.

Valore restituito

C++

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

Al termine di questa funzione, *pDisposition è impostato su uno dei valori della tabella seguente.

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 specifica l'eliminazione della richiesta. L'eliminazione è uno dei valori seguenti.

Codice restituito	Descrizione
CR_DISP_INCOMPLETE	Richiesta non completata
CR_DISP_ERROR	Richiesta non riuscita
CR_DISP_DENIED	Richiesta negata
CR_DISP_ISSUED	Certificato rilasciato
CR_DISP_ISSUED_OUT_OF_BAND	Certificato rilasciato separatamente
CR_DISP_UNDER_SUBMISSION	Richiesta eseguita in invio

Commenti

Una chiamata riuscita a questo metodo genera un evento EXITEVENT_CERTRETRIEVEPENDING. Un modulo di uscita attivo riceverà una notifica di questo evento (tramite una chiamata a ICertExit3::Notify) se il modulo di uscita ha specificato questo evento quando chiama ICertExit3::Initialize.

Esempio

BSTR    bstrCA = NULL;
long    nReqID, nDisp;

// In this example, the request ID is hard-coded.
nReqID = 1234;

// Note use of two '\' in C++ to produce one '\'.
bstrCA = SysAllocString(L"server01\\myCAName");

// pCertRequest is previously instantiated ICertRequest
// object pointer. Retrieve the status for the specified request.
hr = pCertRequest->RetrievePending( nReqID, bstrCA, &nDisp );
if (FAILED(hr))
{
    printf("Failed RetrievePending [%x]\n", hr);
    goto error;
}
else
{
    // Use the disposition value as needed...
}
// Free BSTR resource.
if ( NULL != bstrCA )
    SysFreeString( bstrCA );

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