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.

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

• 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

Vedi anche

IX509CertificateRequestPkcs7