Metodo ISmimeCapability::Initialize (certenroll.h)

  • Articolo

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
CERTSRV_E_PROPERTY_EMPTY
 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

Vedi anche

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities