PFN_CMSG_EXPORT_MAIL_LIST fonction de rappel (wincrypt.h)

Article
07/16/2024

La fonction de rappel PFN_CMSG_EXPORT_MAIL_LIST chiffre et exporte la clé de chiffrement de contenu pour un destinataire de liste de diffusion d’un message enveloppe. PFN_CMSG_EXPORT_MAIL_LIST pouvez être installé à l’aide d’un l’identificateur 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_MAIL_LIST PfnCmsgExportMailList;

BOOL PfnCmsgExportMailList(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO pMailListEncodeInfo,
  [in, out] PCMSG_MAIL_LIST_ENCRYPT_INFO pMailListEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Paramètres

[in] pContentEncryptInfo

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

[in] pMailListEncodeInfo

Pointeur vers une structure CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO qui spécifie la clé utilisée pour chiffrer la clé de chiffrement de contenu.

[in, out] pMailListEncryptInfo

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

[in] dwFlags

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

pvReserved

Ce paramètre est réservé et doit être NULL.

Valeur de retour

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 égale à zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction PFN_CMSG_EXPORT_MAIL_LIST doit mettre à jour le membre EncryptedKey de la structure CMSG_MAIL_LIST_ENCRYPT_INFO pointée par le paramètre pMailListEncryptInfo . Cette fonction doit utiliser les membres pfnAlloc et pfnFree membres de la structure CMSG_CONTENT_ENCRYPT_INFO pointées par le paramètre pContentEncryptInfo pour gérer la mémoire pour toutes les valeurs mises à jour.

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

Constant	Définition
CMSG_OID_EXPORT_MAIL_LIST_FUNC ou CMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	« CryptMsgDllExportMailList »

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wincrypt.h

Partager via