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) |