Método ISmimeCapability::Initialize (certenroll.h)
El método Initialize inicializa el objeto a partir de un identificador de objeto de algoritmo de cifrado simétrico (OID) y una longitud de clave opcional.
Sintaxis
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Parámetros
[in] pObjectId
Puntero a una interfaz IObjectId que representa el OID.
[in] BitCount
Variable LONG que contiene la longitud de bits de la clave simétrica.
Valor devuelto
Si la función se realiza correctamente, la función devuelve S_OK.
Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.
| Código o valor devuelto | Descripción |
|---|---|
|
El puntero IObjectId es NULL. |
Comentarios
La API de inscripción de certificados admite los siguientes algoritmos de cifrado simétricos. Solo los algoritmos RC2 y RC4 tienen longitudes de clave variable que se pueden especificar.
| OID | Longitud de la clave | Descripción |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | El tamaño de clave es del algoritmo CBC de DES es de 56 bits. No es necesario especificar este valor. |
| XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 | 168 | El tamaño de clave es del algoritmo CBC 3DES es de 168 bits. No es necesario especificar este valor. |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | De 40 a 128 | RC4 es un algoritmo de clave variable. Los valores comunes son 40, 64 y 128 bits. |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | De 40 a 128 | RC4 es un algoritmo de clave variable. Los valores comunes son 40, 64 y 128 bits. |
| XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 | 168 | El tamaño de clave del algoritmo de encapsulado de claves de MMS Data Encryption Standard (DES) es de 168 bits. No es necesario especificar este valor. |
| XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 | 128 | El tamaño de clave del algoritmo de encapsulado de claves MMS RC2 es de 128 bits. No es necesario especificar este valor. |
| XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 | 128 | El tamaño de la clave está implícito en el OID. No es necesario especificar este valor. |
| XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 | 192 | El tamaño de la clave está implícito en el OID. No es necesario especificar este valor. |
| XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 | 256 | El tamaño de la clave está implícito en el OID. No es necesario especificar este valor. |
| XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 | 128 | El tamaño de la clave está implícito en el OID. No es necesario especificar este valor. |
| XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 | 192 | El tamaño de la clave está implícito en el OID. No es necesario especificar este valor. |
| XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 | 256 | El tamaño de la clave está implícito en el OID. No es necesario especificar este valor. |
La longitud de clave que especifique para los algoritmos RC2 y RC4 debe ser coherente con la admitida por el proveedor criptográfico o los proveedores usados por el cliente. Para obtener más información, consulte ICspInformation. Puede recuperar la longitud de bits llamando a la propiedad BitCount y puede recuperar el OID del algoritmo llamando a la propiedad ObjectId .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certenroll.h |
| Archivo DLL | CertEnroll.dll |