Applies to: desktop apps only
The PFN_CMSG_IMPORT_MAIL_LIST callback function imports a content encryption key for a key transport recipient of an enveloped message. PFN_CMSG_IMPORT_MAIL_LIST can be installed by using a CryptoAPI object identifier. This function is called by the CryptMsgControl function when its dwCtrlType parameter is set to CMSG_CTRL_DECRYPT.
Syntax
typedef BOOL ( WINAPI *PFN_CMSG_IMPORT_MAIL_LIST)( __in PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm, __in PCMSG_CTRL_MAIL_LIST_DECRYPT_PARA pMailListDecryptPara, __in DWORD dwFlags, __reserved void *pvReserved, __out HCRYPTKEY *phContentEncryptKey );
Parameters
- pContentEncryptionAlgorithm [in]
-
A pointer to a CRYPT_ALGORITHM_IDENTIFIER structure that specifies the algorithm used to encrypt the message contents and any associated parameters.
- pMailListDecryptPara [in]
-
A pointer to a CMSG_CTRL_MAIL_LIST_DECRYPT_PARA structure that contains information about the mailing list recipient.
- dwFlags [in]
-
This value is not used. Set it to zero.
- pvReserved
-
This parameter is reserved and must be NULL.
- phContentEncryptKey [out]
-
The address of a handle to the content encryption key returned by this function.
Return value
If the function succeeds, the return value is nonzero (TRUE).
If the function fails, the return value is zero (FALSE). For extended error information, call GetLastError.
If this callback function does not support the key encryption algorithm, it must return FALSE and call SetLastError with E_NOTIMPL.
Remarks
You can use OID Support Functions to deploy this callback function. Wincrypt.h defines the following constants for this purpose.
| Constant | Definition |
|---|---|
| CMSG_OID_IMPORT_MAIL_LIST_FUNC or CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC | "CryptMsgDllImportMailList" |
Requirements
|
Minimum supported client | Windows 2000 Professional |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
Send comments about this topic to Microsoft
Build date: 3/6/2012