estructura CRYPT_DECRYPT_MESSAGE_PARA (wincrypt.h)

  • Artículo

La estructura CRYPT_DECRYPT_MESSAGE_PARA contiene información para descifrar mensajes.

Sintaxis

typedef struct _CRYPT_DECRYPT_MESSAGE_PARA {
  DWORD      cbSize;
  DWORD      dwMsgAndCertEncodingType;
  DWORD      cCertStore;
  HCERTSTORE *rghCertStore;
  DWORD      dwFlags;
} CRYPT_DECRYPT_MESSAGE_PARA, *PCRYPT_DECRYPT_MESSAGE_PARA;

Miembros

cbSize

Tamaño de esta estructura en bytes.

dwMsgAndCertEncodingType

Tipo de codificación usada. Siempre es aceptable especificar los tipos de codificación de certificados y mensajes mediante su combinación 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

cCertStore

Número de elementos de la matriz rghCertStore .

rghCertStore

Matriz de identificadores de almacén de certificados.

Estos identificadores de almacén de certificados se usan para obtener el contexto de certificado que se usará para descifrar un mensaje. Para obtener más información, vea las funciones de descifrado CryptDecryptMessage y CryptDecryptAndVerifyMessageSignature. Un mensaje cifrado puede tener uno o varios destinatarios. Los destinatarios se identifican mediante un identificador de certificado único, a menudo el hash del emisor de certificados y el número de serie. Se busca en los almacenes de certificados para buscar un contexto de certificado correspondiente al identificador único.

Los destinatarios también se pueden identificar mediante su KeyId. Se admiten los destinatarios de Contrato de clave (Diffie-Hellman) y Transporte de claves (RSA).

Solo se pueden usar contextos de certificado en el almacén con una de las siguientes propiedades, CERT_KEY_PROV_INFO_PROP_ID o CERT_KEY_CONTEXT_PROP_ID. Estas propiedades especifican la ubicación de una clave de intercambio privada necesaria.

dwFlags

El CRYPT_MESSAGE_SILENT_KEYSET_FLAG se puede establecer para suprimir cualquier interfaz de usuario por parte del CSP. Para obtener más información sobre la marca CRYPT_SILENT, vea CryptAcquireContext.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado wincrypt.h

Consulte también

CryptDecryptAndVerifyMessageSignature

CryptDecryptMessage