Metodo ISmimeCapability::Initialize (certenroll.h)
Il metodo Initialize inizializza l'oggetto da un identificatore dell'oggetto dell'algoritmo di crittografia simmetrica (OID) e una lunghezza di chiave facoltativa.
Sintassi
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Parametri
[in] pObjectId
Puntatore a un'interfaccia IObjectId che rappresenta l'OID.
[in] BitCount
Variabile LONG contenente la lunghezza del bit della chiave simmetrica.
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 |
|---|---|
|
Il puntatore IObjectId è NULL. |
Commenti
Gli algoritmi di crittografia simmetrica seguenti sono supportati dall'API Registrazione certificati. Solo gli algoritmi RC2 e RC4 hanno lunghezze di chiave variabile che possono essere specificate.
| OID | Lunghezza chiave | Descrizione |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | La dimensione della chiave è dell'algoritmo DES CBC è di 56 bit. Non è necessario specificare questo valore. |
| XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 | 168 | La dimensione della chiave è dell'algoritmo CBC 3DES è di 168 bit. Non è necessario specificare questo valore. |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | Da 40 a 128 | RC4 è un algoritmo di chiave variabile. i valori comuni sono 40, 64 e 128 bit. |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | Da 40 a 128 | RC4 è un algoritmo di chiave variabile. i valori comuni sono 40, 64 e 128 bit. |
| XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 | 168 | Le dimensioni della chiave dell'algoritmo di wrapping della chiave MMS Data Encryption Standard (DES) sono 168 bit. Non è necessario specificare questo valore. |
| XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 | 128 | Le dimensioni della chiave dell'algoritmo di wrapping della chiave MMS RC2 sono 128 bit. Non è necessario specificare questo valore. |
| XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 | 128 | La dimensione della chiave è implicita dall'OID. Non è necessario specificare questo valore. |
| XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 | 192 | La dimensione della chiave è implicita dall'OID. Non è necessario specificare questo valore. |
| XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 | 256 | La dimensione della chiave è implicita dall'OID. Non è necessario specificare questo valore. |
| XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 | 128 | La dimensione della chiave è implicita dall'OID. Non è necessario specificare questo valore. |
| XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 | 192 | La dimensione della chiave è implicita dall'OID. Non è necessario specificare questo valore. |
| XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 | 256 | La dimensione della chiave è implicita dall'OID. Non è necessario specificare questo valore. |
La lunghezza della chiave specificata per gli algoritmi RC2 e RC4 deve essere coerente con quella supportata dal provider di crittografia o dai provider usati dal client. Per altre informazioni, vedere ICspInformation. È possibile recuperare la lunghezza del bit chiamando la proprietà BitCount e è possibile recuperare l'OID dell'algoritmo chiamando la proprietà ObjectId .
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 |