Método IX509CertificateRequest::Encode (certenroll.h)
El método Encode firma y codifica una solicitud de certificado y crea un par de claves si no existe uno. La solicitud se codifica mediante reglas de codificación distinguida (DER) tal como se define en el estándar Notación de sintaxis abstracta Uno (ASN.1). El proceso de codificación crea una matriz de bytes. Puede recuperar la matriz de bytes llamando a la propiedad RawData .
Sintaxis
HRESULT Encode();
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 |
|---|---|
|
La propiedad ArchivePrivateKey se ha establecido para una solicitud de CMC, pero no se encontró un certificado de intercambio de claves. |
|
El objeto no se inicializa. |
Comentarios
Para una solicitud PKCS #10, este método:
- Novedades la clave privada o crea la clave si es necesario.
- Rellena la clave pública de la clave privada.
- Novedades las extensiones, agregando las extensiones predeterminadas y teniendo en cuenta la colección OID suprimida y la colección OID de extensión crítica.
- Novedades los atributos, agregando atributos predeterminados y teniendo en cuenta la colección de OID suprimida.
- Ensambla y codifica la solicitud actualizada sin firmar.
- Crea y codifica una firma.
- Codifica la firma y la solicitud sin firmar.
Para una solicitud de CMC, este método:
- Codifica todos los objetos de solicitud internos.
- Novedades las extensiones del objeto de solicitud externa, agregando las extensiones predeterminadas y teniendo en cuenta la colección OID suprimida y la colección OID de extensión crítica.
- Novedades los atributos del objeto de solicitud externa, agregando atributos predeterminados y teniendo en cuenta la colección OID suprimida.
- Novedades la colección de pares nombre-valor.
- Codifica el contenido de CMC que consta de la solicitud interna codificada y la solicitud externa actualizada.
- Crea y codifica una firma para cada certificado de firma.
- Crea y codifica una firma principal.
- Ensambla el contenido de CMC codificado (incluida la solicitud interna y la solicitud externa actualizada) y las firmas codificadas.
- Codifica el contenido ensamblado en un mensaje PKCS #7.
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 |