Metodo IX509Enrollment2::InitializeFromTemplate (certenroll.h)

Il metodo InitializeFromTemplate inizializza l'oggetto enrollment utilizzando un modello.

Sintassi

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Parametri

[in] context

Valore di enumerazione X509CertificateEnrollmentContext che indica se la registrazione richiesta è per un utente, un computer o un amministratore che agisce per conto di un computer. Può trattarsi di uno dei valori seguenti.

Valore Significato
ContextUser
Il certificato viene richiesto per un utente finale.
ContextMachine
Il certificato viene richiesto per un computer.
ContextAdministratorForceMachine
Il certificato viene richiesto da un amministratore che agisce per conto di un computer.

[in] pPolicyServer

Puntatore a un oggetto IX509EnrollmentPolicyServer che rappresenta il server CEP (Certificate Enrollment Policy) che contiene il modello specificato dal parametro pTemplate .

[in] pTemplate

Puntatore a un oggetto IX509CertificateTemplate che rappresenta il modello da utilizzare durante l'inizializzazione.

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/valore restituito Descrizione
E_POINTER
I parametri pPolicyServer e pTemplate non possono essere NULL.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
L'oggetto di registrazione è già stato inizializzato.

Commenti

Metodo InitializeFromTemplate :

  • Esamina il modello per determinare il tipo di richiesta necessaria.
  • Crea il tipo appropriato di oggetto richiesta (PKCS #10, PKCS #7 o CMC).
  • Imposta le proprietà seguenti nella richiesta se esistono valori:
  • Inizializza l'oggetto richiesta utilizzando il modello.
  • Recupera il conteggio delle firme, i criteri di rilascio e i criteri dell'applicazione dal modello.

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

IX509Enrollment2