Metodo IX509CertificateRequestCertificate2::InitializeFromPrivateKeyTemplate (certenroll.h)

Il metodo InitializeFromPrivateKeyTemplate inizializza la richiesta del certificato usando un oggetto IX509PrivateKey e un modello di certificato.

Sintassi

HRESULT InitializeFromPrivateKeyTemplate(
  [in] X509CertificateEnrollmentContext Context,
  [in] IX509PrivateKey                  *pPrivateKey,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

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. Questo può essere uno dei valori seguenti. Tuttavia, se la proprietà MachineContext della chiave privata è impostata, è necessario specificare il valore di enumerazione ContextMachine .

[in] pPrivateKey

Puntatore a un'interfaccia IX509PrivateKey che rappresenta la chiave privata.

[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 usare 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 di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Il metodo InitializeFromPrivateKeyTemplate esegue le azioni seguenti:

• Aggiunge le estensioni specificate dal modello a un insieme IX509Extensions .
• Crea un insieme IObjectIds e lo popola con gli identificatori di oggetto XCN_OID_KEY_USAGE predefiniti e XCN_OID_BASIC_CONSTRAINTS2. Se il modello indica che questi ID non sono critici, vengono rimossi dalla raccolta. 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 .
• Recupera un OID dell'algoritmo di crittografia asimmetrica, se presente, dal modello e lo imposta nell'oggetto IX509SignatureInformation .
• Popola molte delle proprietà IX509PrivateKey dalle impostazioni del modello.

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

Nessuna chiave privata viene creata a questo punto. Se l'oggetto IX509PrivateKey passato al metodo non rappresenta una chiave esistente, viene creata una chiave quando viene chiamato il metodo Encode . La chiave verrà creata usando il provider predefinito se non è stato specificato alcun modello e la proprietà ProviderName nella proprietà IX509PrivateKey non è impostata. Quando esiste una chiave privata, è impostata sulla proprietà PrivateKey .

Requisiti

Vedi anche

IX509CertificateRequestCertificate2