PFN_CMSG_EXPORT_MAIL_LIST funzione di callback (wincrypt.h)

La funzione di callback PFN_CMSG_EXPORT_MAIL_LIST crittografa ed esporta la chiave di crittografia del contenuto per un destinatario della lista di distribuzione di un messaggio in busta. PFN_CMSG_EXPORT_MAIL_LIST può essere installato usando un CryptoAPIidentificatore di oggetto (OID). Questa funzione viene chiamata dalla funzione CryptMsgOpenToEncode quando il relativo parametro dwMsgType è impostato su CMSG_ENVELOPED.

Sintassi

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
)
{...}

Parametri

[in] pContentEncryptInfo

Puntatore a una struttura CMSG_CONTENT_ENCRYPT_INFO che contiene la chiave di crittografia del contenuto.

[in] pMailListEncodeInfo

Puntatore a una struttura CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO che specifica la chiave utilizzata per crittografare la chiave di crittografia del contenuto.

[in, out] pMailListEncryptInfo

Puntatore a una struttura CMSG_MAIL_LIST_ENCRYPT_INFO che contiene la chiave di crittografia del contenuto crittografato.

[in] dwFlags

Questo valore non viene utilizzato. Impostarlo su zero.

pvReserved

Questo parametro è riservato e deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero (TRUE).

Se la funzione ha esito negativo, il valore restituito è zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError.

Osservazioni

La funzione PFN_CMSG_EXPORT_MAIL_LIST deve aggiornare il membro encryptedKey della struttura CMSG_MAIL_LIST_ENCRYPT_INFO a cui punta il parametro pMailListEncrypt Info. Questa funzione deve utilizzare il pfnAlloc e membri pfnFree della struttura CMSG_CONTENT_ENCRYPT_INFO a cui punta il parametro pContentEncryptInfo per gestire la memoria per tutti i valori aggiornati.

È possibile usare funzioni di supporto OID per distribuire questa funzione di callback. Wincrypt.h definisce le costanti seguenti a questo scopo.

Fabbisogno