Condividi tramite


PFN_CMSG_IMPORT_MAIL_LIST funzione di callback (wincrypt.h)

La funzione di callback PFN_CMSG_IMPORT_MAIL_LIST importa una chiave di crittografia del contenuto per un destinatario del trasporto chiave di un messaggio in busta. PFN_CMSG_IMPORT_MAIL_LIST può essere installato usando un identificatore di oggetto CryptoAPI. Questa funzione viene chiamata dalla funzione CryptMsgControl quando il parametro dwCtrlType è impostato su CMSG_CTRL_DECRYPT.

Sintassi

PFN_CMSG_IMPORT_MAIL_LIST PfnCmsgImportMailList;

BOOL PfnCmsgImportMailList(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_MAIL_LIST_DECRYPT_PARA pMailListDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Parametri

[in] pContentEncryptionAlgorithm

Puntatore a una struttura CRYPT_ALGORITHM_IDENTIFIER che specifica l'algoritmo utilizzato per crittografare il contenuto del messaggio ed eventuali parametri associati.

[in] pMailListDecryptPara

Puntatore a una struttura di CMSG_CTRL_MAIL_LIST_DECRYPT_PARA che contiene informazioni sul destinatario della lista di distribuzione.

[in] dwFlags

Questo valore non viene utilizzato. Impostarlo su zero.

pvReserved

Questo parametro è riservato e deve essere NULL.

[out] phContentEncryptKey

Indirizzo di un handle per la chiave di crittografia del contenuto restituita da questa funzione.

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.

Se questa funzione di callback non supporta l'algoritmo di crittografia della chiave, deve restituire false e chiamare SetLastError con E_NOTIMPL.

Osservazioni

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

Costante Definizione
CMSG_OID_IMPORT_MAIL_LIST_FUNC o CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC "CryptMsgDllImportMailList"

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
piattaforma di destinazione Finestre
intestazione wincrypt.h