Metodo IX509Enrollment::Enroll (certenroll.h)

  • Articolo

Il metodoRegistra una richiesta, la invia a un'autorità di certificazione appropriata e installa la risposta.

Sintassi

HRESULT Enroll();

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito Descrizione
OLE_E_BLANK
 L'oggetto di registrazione non è stato inizializzato.

Commenti

Se necessario, il metodo può creare una coppia di chiavi. A seconda della modalità di inizializzazione dell'oggetto di registrazione e delle proprietà impostate, potrebbe non essere necessario creare una coppia di chiavi. Ad esempio, se si rinnova un certificato usando una chiave esistente o se l'oggetto IX509PrivateKey associato alla richiesta di certificato rappresenta una chiave esistente, questo metodo non crea una nuova coppia di chiavi.

Prima di registrare, è necessario inizializzare l'oggetto IX509Enrollment chiamando uno dei metodi seguenti.

Se l'operazione di registrazione ha esito positivo, la funzione restituisce S_OK. Tuttavia, questo non significa necessariamente che la risposta della CA è stata installata. Chiamare la proprietà Status per determinare lo stato della registrazione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certenroll.h
DLL CertEnroll.dll

Vedi anche

IX509Enrollment