Metodo IX509EnrollmentHelper::Enroll (certenroll.h)

Articolo
02/26/2024

Il metodo Enroll registra una richiesta di certificato e recupera il certificato emesso. Questo metodo è abilitato per il Web.

Sintassi

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Parametri

[in] strEnrollmentPolicyServerURI

BSTR che contiene l'URL del server dei criteri di registrazione certificati.

[in] strTemplateName

Variabile BSTR che contiene il nome comune (CN) del modello come viene visualizzato in Active Directory o nell'identificatore di oggetto decimale punteggiato.

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica applicato a una matrice di byte a scopo di visualizzazione.

[in] enrollFlags

Valore di enumerazione WebEnrollmentFlags che specifica il comportamento di registrazione Web. Può trattarsi del valore seguente.

Valore	Significato
EnrollPrompt	Se questo flag è impostato e non sono disponibili credenziali di autenticazione per il server di registrazione certificati, il servizio certificati richiede le credenziali. Se non sono presenti credenziali di autenticazione e questo flag non è impostato, il metodo Enroll ha esito negativo.

[out, retval] pstrCertificate

BSTR che contiene il certificato emesso.

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 dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice restituito	Descrizione
E_INVALIDARG	I parametri strEnrollmentPolicyServerURI e strTemplateName non possono essere NULL.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)	I parametri strEnrollmentPolicyServerURI e strTemplateName superano i 64.000 caratteri o contengono caratteri Null incorporati.

Commenti

Il metodo Enroll recupera il modello appropriato, chiama InitializeFromTemplate e quindi chiama Enroll sull'oggetto IX509Enrollment .

Questo metodo non ha installato il certificato emesso.

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	certenroll.h

Vedi anche

IX509EnrollmentHelper