PFN_CMSG_EXPORT_KEY_TRANS fonction de rappel (wincrypt.h)

  • Article

La fonction de rappel PFN_CMSG_EXPORT_KEY_TRANS chiffre et exporte la clé de chiffrement de contenu pour un destinataire de transport de clé d’un message enveloppe. PFN_CMSG_EXPORT_KEY_TRANS pouvez être installés à l’aide d’unidentificateur d’objet CryptoAPI (OID). Cette fonction est appelée par la fonction CryptMsgOpenToEncode lorsque son paramètre dwMsgType est défini sur CMSG_ENVELOPED.

Syntaxe

PFN_CMSG_EXPORT_KEY_TRANS PfnCmsgExportKeyTrans;

BOOL PfnCmsgExportKeyTrans(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_KEY_TRANS_RECIPIENT_ENCODE_INFO pKeyTransEncodeInfo,
  [in, out] PCMSG_KEY_TRANS_ENCRYPT_INFO pKeyTransEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Paramètres

[in] pContentEncryptInfo

Pointeur vers une structure de CMSG_CONTENT_ENCRYPT_INFO qui contient la clé de chiffrement de contenu.

[in] pKeyTransEncodeInfo

Pointeur vers une structure de CMSG_KEY_TRANS_RECIPIENT_ENCODE_INFO qui spécifie la clé publique du destinataire utilisée pour chiffrer la clé de chiffrement de contenu.

[in, out] pKeyTransEncryptInfo

Pointeur vers une structure de CMSG_KEY_TRANS_ENCRYPT_INFO qui contient la clé de chiffrement de contenu chiffré.

[in] dwFlags

Cette valeur n'est pas utilisée. Définissez-le sur zéro.

pvReserved

Cette valeur est réservée. Définissez-le sur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro (TRUE).

Si la fonction échoue, la valeur de retour est zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction PFN_CMSG_EXPORT_KEY_TRANS doit mettre à jour le membre EncryptedKey de la structure CMSG_KEY_TRANS_ENCRYPT_INFO pointée par le paramètre pKeyTransEncryptInfo . Cette fonction doit utiliser les membres pfnAlloc et pfnFree de la structure CMSG_CONTENT_ENCRYPT_INFO pointée par le paramètre pContentEncryptInfo pour gérer l’allocation de mémoire pour la clé chiffrée.

Vous pouvez utiliser les fonctions de support OID pour déployer cette fonction de rappel. Wincrypt.h définit les constantes suivantes à cet effet.

Vous devez définir différentes fonctions de rappel pour les clés CAPI1 et l’API chiffrement : clés CNG (Next Generation). Les deux fonctions ont la même signature, mais utilisent des OID différents. La fonction appelée dépend de la valeur du membre fCNG de la structure CMSG_CONTENT_ENCRYPT_INFO pointée par le paramètre pContentEncryptInfo . Le tableau suivant montre la relation entre la fonction de rappel et la valeur du membre fCNG .

Valeur fCNG Constant Définition
FALSE CMSG_OID_EXPORT_KEY_TRANS_FUNC ou CMSG_OID_CAPI1_EXPORT_KEY_TRANS_FUNC « CryptMsgDllExportKeyTrans »
TRUE CMSG_OID_CNG_EXPORT_KEY_TRANS_FUNC « CryptMsgDllCNGExportKeyTrans »

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wincrypt.h