Interfaccia ICertRequest (certcli.h)

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)