Función CryptMsgEncodeAndSignCTL (wincrypt.h)

Artículo
03/13/2024

La función CryptMsgEncodeAndSignCTL codifica un CTL y crea un mensaje firmado que contiene el CTL codificado.

Esta función codifica primero el CTL al que apunta pCtlInfo y, a continuación, llama a CryptMsgSignCTL para firmar el mensaje codificado.

Sintaxis

BOOL CryptMsgEncodeAndSignCTL(
  [in]      DWORD                    dwMsgEncodingType,
  [in]      PCTL_INFO                pCtlInfo,
  [in]      PCMSG_SIGNED_ENCODE_INFO pSignInfo,
  [in]      DWORD                    dwFlags,
  [out]     BYTE                     *pbEncoded,
  [in, out] DWORD                    *pcbEncoded
);

Parámetros

[in] dwMsgEncodingType

Especifica el tipo de codificación usado. Siempre es aceptable especificar los tipos de codificación de certificados y mensajes al combinarlos con una operación OR bit a bit, como se muestra en el ejemplo siguiente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Los tipos de codificación definidos actualmente son:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pCtlInfo

Puntero a la estructura de CTL_INFO que contiene el CTL que se va a codificar y firmar.

[in] pSignInfo

Puntero a una estructura de CMSG_SIGNED_ENCODE_INFO que contiene una matriz de estructuras de CMSG_SIGNER_ENCODE_INFO .

El mensaje se puede codificar sin firmantes si el miembro cbSize de la estructura se establece en el tamaño de la estructura y todos los demás miembros se establecen en cero.

[in] dwFlags

CMSG_ENCODE_SORTED_CTL_FLAG se establece si las entradas de CTL se van a ordenar antes de codificar. Esta marca se establece si se llamará a las funciones CertFindSubjectInSortedCTL o CertEnumSubjectInSortedCTL .

CMSG_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG se establece si se establece CMSG_ENCODE_SORTED_CTL_FLAG y el identificador de TrustedSubjects es un hash, como MD5 o SHA1.

Si se define CMS_PKCS7, dwFlags se puede establecer en CMSG_CMS_ENCAPSULATED_CTL_FLAG para codificar un mensaje SignedData compatible con CMS.

[out] pbEncoded

Puntero a un búfer que recibe el mensaje codificado y firmado creado.

Este parámetro puede ser NULL para establecer el tamaño de esta información con fines de asignación de memoria. Para obtener más información, vea Recuperar datos de longitud desconocida.

[in, out] pcbEncoded

Puntero a un DWORD que especifica el tamaño, en bytes, del búfer pbEncoded . Cuando la función devuelve, DWORD contiene el número de bytes almacenados o que se almacenarán en el búfer.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).

Si se produce un error en la función, el valor devuelto es cero (FALSE). Para obtener información de error extendida, llame a GetLastError. Los errores se pueden propagar desde llamadas a CryptMsgOpenToEncode y CryptMsgUpdate.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll