Metodo IX509Enrollment::InitializeFromTemplateName (certenroll.h)

  • Articolo

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:
  • 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