Condividi tramite


Interfaccia ICertRequest3 (certcli.h)

L'interfaccia ICertRequest3 è una delle tre interfacce che forniscono comunicazioni tra un'applicazione client o intermediaria e Servizi certificati.

Le applicazioni client e intermediarie possono chiamare i metodi ICertRequest3 per eseguire le attività seguenti:

  • Inviare una richiesta di certificato.
  • Recuperare l'eliminazione, l'ultimo stato e l'identificatore di una richiesta.
  • Recuperare il certificato rilasciato 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.
  • Recuperare il valore della proprietà CA, il nome visualizzato e tutti i flag associati alla proprietà.
  • Recuperare i dati di risposta memorizzati nella cache restituiti dal server.
  • Recuperare il testo del messaggio di errore per un codice di errore HRESULT .

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

Le interfacce di Servizi certificati supportano sia modelli di threading a apartment che free-threading. Per migliorare la velocità effettiva, è consigliabile eseguire il threading gratuito.

Ereditarietà

L'interfaccia ICertRequest3 eredita da ICertRequest2, ICertRequest e IDispatch. ICertRequest3 include anche questi tipi di membri:

Metodi

L'interfaccia ICertRequest3 include questi metodi.

 
ICertRequest3::GetIssuedCertificate2

Recupera l'eliminazione di un certificato specificando la stringa ID richiesta o il numero di serie del certificato.
ICertRequest3::GetRefreshPolicy

Restituisce un valore che indica se i criteri di registrazione del certificato memorizzati nella cache di un client non sono aggiornati e devono essere aggiornati.
ICertRequest3::GetRequestIdString

Ottiene il numero di richiesta interno corrente, formattato come stringa, per la richiesta e il certificato successivo.
ICertRequest3::SetCredential

Imposta le credenziali usate per contattare il servizio Web registrazione certificati.

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)

Vedi anche

ICertRequest

ICertRequest2

Idispatch