Interfaccia IX509Enrollment (certenroll.h)

L'interfaccia IX509Enrollment rappresenta l'oggetto di primo livello e consente di eseguire la registrazione in una gerarchia di certificati e di installare una risposta del certificato. Il processo di registrazione supporta i tre scenari seguenti:

Registrazione fuori banda

1. Chiamare qualsiasi metodo di inizializzazione implementato dall'oggetto IX509Enrollment .
2. Chiamare il metodo CreateRequest .
3. Inviare la richiesta fuori banda (manualmente o tramite un altro processo).
4. Ricevere la risposta da un'autorità di certificazione o registrazione.
5. Chiamare il metodo InstallResponse .

Registrazione automatica

1. Chiamare qualsiasi metodo di inizializzazione implementato dall'oggetto IX509Enrollment .
2. Chiamare il metodo Enroll .

Registrazione ritardata

1. Chiamare qualsiasi metodo di inizializzazione implementato dall'oggetto IX509Enrollment .
2. Chiamare il metodo CreateRequest .
3. Archiviare la richiesta per un periodo di tempo, ad esempio giorni o settimane.
4. Chiamare il metodo Initialize per creare un oggetto richiesta quando si è pronti per la registrazione.
5. Popolare l'oggetto richiesta dalla richiesta archiviata.
6. Chiamare il metodo InstallResponse .

Ereditarietà

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

Metodi

L'interfaccia IX509Enrollment include questi metodi.

IX509Enrollment::CreatePFX Crea un messaggio PFX (Personal Information Exchange).
IX509Enrollment::CreateRequest Recupera una richiesta di certificato codificata.
IX509Enrollment::Enroll Codifica una richiesta, la invia a un'autorità di certificazione appropriata e installa la risposta.
IX509Enrollment::get_CAConfigString Recupera la stringa di configurazione che identifica l'autorità di certificazione (CA) a cui è stata inviata la richiesta di certificato.
IX509Enrollment::get_Certificate Recupera il certificato installato.
IX509Enrollment::get_CertificateDescription Specifica o recupera una stringa contenente una descrizione del certificato. (Get)
IX509Enrollment::get_CertificateFriendlyName Specifica o recupera il nome visualizzato di un certificato. (Get)
IX509Enrollment::get_EnrollmentContext Recupera un contesto di registrazione che identifica se il certificato è destinato a un computer o a un utente finale.
IX509Enrollment::get_NameValuePairs Recupera una raccolta di coppie nome-valore associate all'oggetto enrollment.
IX509Enrollment::get_ParentWindow Specifica o recupera l'ID della finestra utilizzata per visualizzare le informazioni di registrazione. (Get)
IX509Enrollment::get_Request Recupera la richiesta di certificato associata all'oggetto di registrazione.
IX509Enrollment::get_RequestId Recupera un identificatore univoco per la richiesta di certificato inviata all'autorità di certificazione dal metodo Enroll.
IX509Enrollment::get_Response Recupera la risposta del certificato restituita da un'autorità di certificazione.
IX509Enrollment::get_Silent Specifica o recupera un valore booleano che indica se un'interfaccia utente viene visualizzata durante il processo di registrazione del certificato. (Get)
IX509Enrollment::get_Status Recupera un oggetto IX509EnrollmentStatus che può essere utilizzato per monitorare lo stato del processo di registrazione e recuperare le informazioni sugli errori.
IX509Enrollment::Initialize Inizializza l'oggetto di registrazione e crea un PKCS predefinito
IX509Enrollment::InitializeFromRequest Inizializza l'oggetto di registrazione da un oggetto IX509CertificateRequest esistente.
IX509Enrollment::InitializeFromTemplateName Inizializza l'oggetto registrazione da un nome comune del modello.
IX509Enrollment::InstallResponse Installa una catena di certificati nel computer dell'entità finale. (IX509Enrollment.InstallResponse)
IX509Enrollment::p ut_CertificateDescription Specifica o recupera una stringa contenente una descrizione del certificato. (Put)
IX509Enrollment::p ut_CertificateFriendlyName Specifica o recupera il nome visualizzato di un certificato. (Put)
IX509Enrollment::p ut_ParentWindow Specifica o recupera l'ID della finestra utilizzata per visualizzare le informazioni di registrazione. (Put)
IX509Enrollment::p ut_Silent Specifica o recupera un valore booleano che indica se un'interfaccia utente viene visualizzata durante il processo di registrazione del certificato. (Put)

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h

Vedi anche

API di registrazione certificato

Idispatch

IX509EnrollmentStatus