Metodo IX509Enrollment::InitializeFromTemplateName (certenroll.h)

Il metodo InitializeFromTemplateName inizializza l'oggetto di registrazione da un nome comune del modello (CN).

Sintassi

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

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.

[in] strTemplateName

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

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto di registrazione è già stato inizializzato.

Commenti

Metodo InitializeFromTemplateName :

• Esamina il modello per determinare il tipo di richiesta necessaria.
• Crea il tipo appropriato di oggetto request (PKCS #10, PKCS #7 o CMC).
• Imposta le proprietà seguenti nella richiesta se esistono valori:
  • CspInformations
  • ParentWindow
  • Invisibile all'utente
• Inizializza l'oggetto request usando 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 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