Función CryptMsgUpdate (wincrypt.h)

La función CryptMsgUpdate agrega contenido a un mensaje criptográfico. El uso de esta función permite que los mensajes se construyan por partes mediante llamadas repetitivas de CryptMsgUpdate. El contenido del mensaje agregado se codifica o descodifica en función de si el mensaje se abrió con CryptMsgOpenToEncode o CryptMsgOpenToDecode.

Sintaxis

BOOL CryptMsgUpdate(
  [in] HCRYPTMSG  hCryptMsg,
  [in] const BYTE *pbData,
  [in] DWORD      cbData,
  [in] BOOL       fFinal
);

Parámetros

[in] hCryptMsg

Identificador de mensaje criptográfico del mensaje que se va a actualizar.

[in] pbData

Puntero al búfer que contiene los datos que se van a codificar o descodificar.

[in] cbData

Número de bytes de datos en el búfer pbData .

[in] fFinal

Indica que se está procesando el último bloque de datos para la codificación o descodificación. El uso correcto de esta marca depende de si el mensaje que se está procesando tiene datos desasociados. La inclusión de datos desasociados en un mensaje se indica estableciendo dwFlags en CMSG_DETACHED_FLAG en la llamada a la función que abrió el mensaje.

Si no se estableció CMSG_DETACHED_FLAG y el mensaje se abrió con CryptMsgOpenToDecode o CryptMsgOpenToEncode, fFinal se establece en TRUE y solo se llama a CryptMsgUpdate una vez.

Si se estableció la marca CMSG_DETACHED_FLAG y se abre un mensaje mediante CryptMsgOpenToEncode, fFinal se establece en TRUE solo en la última llamada a CryptMsgUpdate.

Si se estableció la marca CMSG_DETACHED_FLAG y se abre un mensaje mediante CryptMsgOpenToDecode, fFinal se establece en TRUE cuando el encabezado se procesa mediante una sola llamada a CryptMsgUpdate. Se establece en FALSE mientras se procesan los datos desasociados en llamadas posteriores a CryptMsgUpdate hasta que se va a procesar el último bloque de datos desasociado. En la última llamada a CryptMsgUpdate, se establece en TRUE.

Cuando se descodifican los datos desasociados, el encabezado y el contenido de un mensaje se encuentran en blobs diferentes. Cada BLOB requiere que fFinal se establezca en TRUE cuando se realice la última llamada a la función para ese BLOB.

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 encontrados en la función de devolución de llamada definida por la aplicación especificada por pStreamInfo en CryptMsgOpenToDecode y CryptMsgOpenToEncode podrían propagarse a CryptMsgUpdate si se usa el streaming. Si esto sucede, CryptMsgUpdate no llama a SetLastError después de que se devuelva la función de devolución de llamada, lo que conserva los errores encontrados bajo el control de la aplicación. Es responsabilidad de la función de devolución de llamada (o una de las API a las que llama) llamar a SetLastError si se produce un error mientras la aplicación procesa los datos transmitidos.

En la tabla siguiente se enumeran los códigos de error devueltos normalmente por la función GetLastError .

Es posible que se produzcan errores propagados desde cualquiera de las funciones siguientes:

• CryptHashData
• CryptGetHashParam
• CryptSignHash
• CryptGetKeyParam
• CryptEncrypt
• CryptCreateHash

Si se produce un error en la función, GetLastError puede devolver un error de codificación y descodificación de sintaxis abstracta uno (ASN.1). Para obtener información sobre estos errores, vea Valores devueltos de codificación y descodificación de ASN.1.

Requisitos

Consulte también

CryptMsgGetParam

CryptMsgOpenToDecode

CryptMsgOpenToEncode

Funciones de mensaje de bajo nivel

Funciones de mensaje simplificadas