Metodo IX509CertificateRequestCmc::InitializeFromInnerRequestTemplateName (certenroll.h)

Articolo
03/14/2023

Il metodo InitializeFromInnerRequestTemplateName inizializza la richiesta di certificato da un oggetto richiesta interna e un modello.

Sintassi

HRESULT InitializeFromInnerRequestTemplateName(
  [in] IX509CertificateRequest *pInnerRequest,
  [in] BSTR                    strTemplateName
);

Parametri

[in] pInnerRequest

Puntatore a un'interfaccia IX509CertificateRequest che rappresenta l'oggetto richiesta interna. Può trattarsi di una richiesta PKCS #10 o cmC.

[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
CRYPT_E_INVALID_MSG_TYPE	L'oggetto request passato al parametro pInnerRequest deve essere una richiesta PKCS #10 o cmC.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto request è già stato inizializzato.

Commenti

Specificando un modello, è possibile aggiungere informazioni all'oggetto richiesta esterna che potrebbe non essere contenuto nella richiesta interna. Ad esempio, se la richiesta interna non contiene le estensioni necessarie, è possibile fornire un modello che esegue.

Metodo InitializeFromInnerRequestTemplateName :

Crea un insieme ICryptAttributes vuoto.
Crea un insieme IX509NameValuePairs vuoto.
Crea un insieme IX509Extensions vuoto.
Crea un insieme IObjectIds per le estensioni critiche e aggiunge i XCN_OID_KEY_USAGE e gli identificatori di oggetto XCN_OID_BASIC_CONSTRAINTS2 (OID).
Crea un insieme IObjectIds vuoto da eliminare dall'oggetto request.
Crea un insieme ISignerCertificates vuoto.
Recupera i flag di chiave privata dal modello.
Imposta la proprietà ArchivePrivateKey se richiesto dai flag o dalle impostazioni del modello.
Recupera l'algoritmo di crittografia dal modello se è specificato e imposta la proprietà EncryptionAlgorithm .
Imposta la proprietà EncryptionStrength , se possibile.

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

IX509CertificateRequestCmc