Interfaccia ICertRequest (certcli.h)

  • Articolo

L'interfaccia ICertRequest fornisce comunicazioni tra un'applicazione client o intermedia e i servizi certificati.

Le applicazioni client e intermedie possono chiamare i metodi ICertRequest per eseguire le attività seguenti:

  • Inviare la richiesta di certificato.
  • Recuperare l'eliminazione, l'ultimo stato e l'identificatore di una richiesta.
  • Recuperare il certificato emesso per la richiesta.
  • Recuperare i certificati in sospeso per le richieste precedenti.
  • Recuperare il certificato dell'autorità di certificazione (CA) per il server servizi certificati.

ICertRequest è definito in Certcli.h. Quando si crea il programma, tuttavia, usare Certsrv.h come file di inclusione. Certcli.dll fornisce l'interfaccia ICertRequest . Le informazioni sul tipo per questa interfaccia sono disponibili anche in Certclil.dll, fornito con Platform Software Development Kit (SDK).

Le interfacce di Servizi certificati supportano sia modelli di threading apartment che di threading libero. Per una migliore velocità effettiva, è consigliabile usare il threading gratuito.

Ereditarietà

L'interfaccia ICertRequest eredita dall'interfaccia IDispatch . ICertRequest include anche questi tipi di membri:

Metodi

L'interfaccia ICertRequest include questi metodi.

 
ICertRequest::GetCACertificate

Restituisce il certificato dell'autorità di certificazione (CA) per il server servizi certificati.
ICertRequest::GetCertificate

Restituisce il certificato emesso per la richiesta come certificato X.509 o, facoltativamente, incluso in un pacchetto pkCS (Public Key Cryptography Standards)
ICertRequest::GetDispositionMessage

Ottiene un messaggio leggibile che fornisce l'eliminazione corrente della richiesta di certificato.
ICertRequest::GetLastStatus

Ottiene l'ultimo codice restituito per questa richiesta. In questo modo vengono restituite le informazioni sul codice di errore, anziché l'eliminazione della richiesta.
ICertRequest::GetRequestId

Ottiene il numero di richiesta interno corrente per la richiesta e il certificato successivo.
ICertRequest::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.
ICertRequest::Submit

Invia una richiesta al server servizi certificati.

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)