Metodo IX509Enrollment2::InitializeFromTemplate (certenroll.h)

Articolo
02/28/2024

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

Condividi tramite