Método ISmimeCapability::Initialize (certenroll.h)

  • Artículo

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

Consulte también

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities