Metodo ICertRequest3::GetIssuedCertificate2 (certcli.h)

Articolo
02/26/2024

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

Sintassi

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          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 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.

[in] strRequestId

Valore BSTR che rappresenta l'ID richiesta di certificato nel database Di Servizi certificati. Impostare questo parametro su NULL se il numero di serie (passato come strSerialNumber) deve essere usato anziché l'ID richiesta.

Usare il metodo ICertRequest3::GetRequestIdString per ottenere la stringa ID richiesta.

[in] strSerialNumber

Valore BSTR che rappresenta il numero di serie del certificato, come emesso dalla CA. La stringa deve specificare il numero di serie come numero uniforme di cifre esadecimali. Se necessario, un valore zero può essere preceduto dal numero per produrre un numero pari di cifre. Tuttavia, non è possibile usare più di uno zero iniziale.

Il valore strSerialNumber viene usato solo quando strRequestId è impostato su NULL.

[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	La richiesta non è stata completata.
CR_DISP_ISSUED	Certificato rilasciato.
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 di 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 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certcli.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certcli.dll

Vedi anche

CCertRequest

ICertRequest3