Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Syntax
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 ejecuta 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, entre otros, los de la tabla siguiente. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.
| Código y valor devueltos | Description |
|---|---|
|
El puntero IObjectId es NULL. |
Observaciones
La API de inscripción de certificados admite los siguientes algoritmos de cifrado simétrico. Solo los algoritmos RC2 y RC4 tienen longitudes de clave variable que se pueden especificar.
| OID | Longitud de la clave | Description |
|---|---|---|
| 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 ajuste de teclas 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 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 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 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 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 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 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 utilizados 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
| Requirement | Importancia |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| de la plataforma de destino de | Windows |
| Header | certenroll.h |
| DLL de |
CertEnroll.dll |