Metodo IX509CertificateRequestPkcs7::InitializeFromTemplateName (certenroll.h)

Il metodo InitializeFromTemplateName inizializza la richiesta di certificato usando un modello.

Sintassi

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

Parametri

[in] Context

Valore di enumerazione X509CertificateEnrollmentContext che specifica se il certificato richiesto è destinato a un utente finale, un computer o un amministratore che agisce per conto del 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
ERROR_ALREADY_INITIALIZED	L'oggetto richiesta certificato è già stato inizializzato.

Commenti

Il metodo InitializeFromTemplateName crea un oggetto richiesta PKCS #7 e imposta le proprietà seguenti sui valori esistenti prima della chiamata di questo metodo:

• CspInformations
• ParentWindow
• Invisibile all'utente
• UIContextMessage

Il metodo crea le raccolte seguenti:

• Insieme ICryptAttributes .
• Raccolta IX509Extensions .
• Insieme IObjectIds popolato con i XCN_OID_KEY_USAGE predefiniti e gli identificatori di oggetto XCN_OID_BASIC_CONSTRAINTS2.
• Insieme IObjectIds vuoto per gli OID di attributo e estensione da eliminare dalla nuova richiesta.

Il metodo esamina quindi il modello ed esegue le azioni seguenti:

• Aggiunge le estensioni specificate dal modello all'insieme IX509Extensions .
• Rimuove le estensioni critiche predefinite (XCN_OID_KEY_USAGE e XCN_OID_BASIC_CONSTRAINTS2) dalla raccolta se il modello indica che non sono critici. Vengono aggiunti gli ID contrassegnati come critici dal modello.
• Imposta la proprietà SmimeCapabilities se il modello supporta algoritmi simmetrici.
• Imposta la proprietà AlternateSignatureAlgorithm se il modello richiede un OID dell'algoritmo di firma discreto.
• Crea un oggetto IX509SignatureInformation .
• Crea un OID dell'algoritmo hash se l'algoritmo viene specificato nel modello e lo imposta nell'oggetto IX509SignatureInformation .
• Crea un OID di crittografia asimmetrica se l'algoritmo viene specificato nel modello e lo imposta nell'oggetto IX509SignatureInformation .
• Imposta le proprietà IX509PrivateKey seguenti dalle impostazioni del modello:
  • KeySpec
  • KeyUsage
  • Lunghezza
  • ExportPolicy
  • KeyProtection
  • SecurityDescriptor
  • Invisibile all'utente
  • MachineContext
  • Algoritmo

Se la proprietà CSPInformations è NULL, il metodo crea un insieme ICspInformations dai provider installati nel computer.

Infine, il metodo imposta la richiesta PKCS #10 inizializzata come oggetto richiesta interna.

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

IX509CertificateRequestPkcs7