estructura de CMSG_CTRL_DECRYPT_PARA (wincrypt.h)

Artículo
08/27/2023

La estructura CMSG_CTRL_DECRYPT_PARA contiene información utilizada para descifrar un mensaje sobre para un destinatario de transporte de claves. Esta estructura se pasa a CryptMsgControl si el parámetro dwCtrlType es CMSG_CTRL_DECRYPT.

Para obtener información sobre cómo CryptoAPI admite la interoperabilidad de correo electrónico de Extensiones de correo electrónico seguras o multipropósito (S/MIME), consulte la sección Comentarios de CryptMsgOpenToEncode.

Sintaxis

typedef struct _CMSG_CTRL_DECRYPT_PARA {
  DWORD cbSize;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD dwKeySpec;
  DWORD dwRecipientIndex;
} CMSG_CTRL_DECRYPT_PARA, *PCMSG_CTRL_DECRYPT_PARA;

Miembros

cbSize

Tamaño, en bytes, de esta estructura.

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Identificador del proveedor de servicios criptográficos (CSP). Se llama a la función NCryptIsKeyHandle de CNG para determinar la elección de unión.

DUMMYUNIONNAME.hNCryptKey

Identificador del proveedor de servicios criptográficos (CSP) de CNG. Se llama a la función CNG, NCryptIsKeyHandle, para determinar la elección de unión. Los nuevos algoritmos de cifrado solo se admiten en las funciones de CNG. Se llamará a la función CNG, NCryptTranslateHandle, para convertir la opción CryptoAPI hCryptProv cuando sea necesario. Se recomienda que las aplicaciones pasen, al miembro hNCryptKey , el identificador de CSP de CNG que se devuelve de la función NCryptOpenKey .

dwKeySpec

Clave privada que se va a usar. Este miembro no se usa cuando se usa el miembro hNCryptKey .

Los siguientes valores dwKeySpec se definen para el proveedor predeterminado.

Valor	Significado
AT_KEYEXCHANGE	Claves usadas para cifrar y descifrar claves de sesión.
AT_SIGNATURE	Claves usadas para crear y comprobar firmas digitales.

Si dwKeySpec es cero, se usa el AT_KEYEXCHANGE predeterminado.

dwRecipientIndex

Índice del destinatario del mensaje asociado a la clave privada hCryptProv .

Requisitos


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

CryptMsgControl