Interfaccia ICertAdmin (certadm.h)

L'interfaccia ICertAdmin fornisce funzionalità di amministrazione per i client autorizzati correttamente.

L'interfaccia ICertAdmin viene usata per eseguire le attività seguenti:

• Autorizzare o negare una richiesta di certificato.
• Revocare un certificato emesso.
• Attivare la generazione di un elenco di revoche di certificati (CRL).
• Ottenere il CRL corrente per il server.
• Determinare se un certificato è valido.

Quando si usa l'interfaccia ICertAdmin , si dispone dell'accesso in sola scrittura per richiedere attributi ed estensioni del certificato, ma non è possibile accedere direttamente ad altre proprietà di richiesta e certificato.

ICertAdmin è definito in Certadm.h. Quando si crea un programma, tuttavia, usare Certsrv.h come file di inclusione. Certadm.dll fornisce invece l'implementazione dell'interfaccia ICertAdmin . Le informazioni sul tipo per questa interfaccia sono disponibili anche in Certadml.dll, fornito con Platform Software Development Kit (SDK).

Le attività di amministrazione usano DCOM. Il codice che chiama questo metodo di interfaccia come definito in una versione precedente di Certadm.h verrà eseguito su server basati su Windows, purché il client e il server eseguano entrambi lo stesso sistema operativo Windows.

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 ICertAdmin eredita dall'interfaccia IDispatch . ICertAdmin ha anche questi tipi di membri:

Metodi

L'interfaccia ICertAdmin include questi metodi.

ICertAdmin::D enyRequest Nega una richiesta di certificato specificata in sospeso.
ICertAdmin::GetCRL Recupera l'elenco di revoche di certificati corrente (CRL) per l'autorità di certificazione (CA) di Servizi certificati.
ICertAdmin::GetRevocationReason Restituisce il motivo per cui un certificato è stato revocato. Questo metodo è stato definito per la prima volta nell'interfaccia ICertAdmin.
ICertAdmin::ImportCertificate Accetta un certificato rilasciato in precedenza e lo importa nel database dell'autorità di certificazione (CA). Questo metodo è stato definito per la prima volta nell'interfaccia ICertAdmin.
ICertAdmin::IsValidCertificate Verifica il certificato sulla chiave dell'autorità di certificazione (CA) e verifica che il certificato non sia stato revocato. Questo metodo è stato definito per la prima volta nell'interfaccia ICertAdmin.
ICertAdmin::P ublishCRL Invia una richiesta all'autorità di certificazione (CA) di Servizi certificati per pubblicare un nuovo elenco di revoche di certificati (CRL). Questo metodo è stato introdotto per la prima volta nell'interfaccia ICertAdmin.
ICertAdmin::ResubmitRequest Invia la richiesta di certificato specificata al modulo criteri per l'autorità di certificazione specificata. Questo metodo è stato introdotto per la prima volta nell'interfaccia ICertAdmin.
ICertAdmin::RevokeCertificate Revoca un certificato in base a una data specificata o immediatamente. Questo metodo è stato definito per la prima volta nell'interfaccia ICertAdmin.
ICertAdmin::SetCertificateExtension Aggiunge una nuova estensione al certificato emesso in risposta a una richiesta di certificato. Questo metodo è stato definito per la prima volta dall'interfaccia ICertAdmin.
ICertAdmin::SetRequestAttributes Imposta gli attributi nella richiesta di certificato in sospeso specificata. Questo metodo è stato definito per la prima volta nell'interfaccia ICertAdmin.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certadm.h (include Certsrv.h)