Metodo ICertRequest2::GetIssuedCertificate (certcli.h)

  • Articolo

Il metodo GetIssuedCertificate recupera l'eliminazione di un certificato specificando l'ID richiesta o il numero di serie del certificato.

Questo metodo equivale in effetti a chiamare ICertRequest3::RetrievePending, con la funzionalità aggiuntiva di specificare un numero di serie per il certificato in questione.

Sintassi

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

Parametri

[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 NomeComputer\CAName, dove NomeComputer è 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.

[in] RequestId

Valore LONG che rappresenta l'ID richiesta certificato nel database di Certificates Services. Usare –1 per questo valore se il numero di serie (passato come strSerialNumber) deve essere usato anziché l'ID richiesta.

[in] strSerialNumber

Valore BSTR che rappresenta il numero di serie del certificato, come emesso dalla CA. Per usare strSerialNumber , è necessario specificare il valore –1 per RequestId.

[out, retval] pDisposition

Puntatore a un valore LONG che rappresenta l'eliminazione del certificato. L'eliminazione è uno dei valori seguenti.

Valore Significato
CR_DISP_DENIED
 Richiesta negata.
CR_DISP_ERROR
 Richiesta non riuscita.
CR_DISP_INCOMPLETE
 Richiesta non completata.
CR_DISP_ISSUED
 Certificato emesso.
CR_DISP_ISSUED_OUT_OF_BAND
 Certificato rilasciato separatamente.
CR_DISP_UNDER_SUBMISSION
 Richiesta eseguita in fase di invio.

Valore restituito

C++

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

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

VB

Il valore restituito è un valore Long che rappresenta l'eliminazione del certificato.

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