PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY callback function (wincrypt.h)
The PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY callback function imports an already decrypted content encryption key (CEK). The PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY function can be installed by using a Cryptography API: Next Generation (CNG) object identifier (OID).
Syntax
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;
BOOL PfnCmsgCngImportContentEncryptKey(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
Parameters
[in, out] pCNGContentDecryptInfo
A pointer to a CMSG_CNG_CONTENT_DECRYPT_INFO structure to be updated with the imported CEK. This structure contains all the relevant information passed to the CryptMsgControl function.
[in] dwFlags
This parameter is reserved. Set it to zero.
pvReserved
This parameter is reserved. Set it to NULL.
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 ERROR_NOT_SUPPORTED.
Remarks
The CryptMsgControl function calls this function for the following operations specified by its dwCtrlType parameter:
- CMSG_CTRL_DECRYPT
- CMSG_CTRL_KEY_TRANS_DECRYPT
- CMSG_CTRL_KEY_AGREE_DECRYPT
You can use OID Support Functions to deploy this callback function. Wincrypt.h defines the following constant for this purpose.
Constant | Definition |
---|---|
CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC | "CryptMsgDllCNGImportContentEncryptKey" |
Examples
For an example that deploys an OID-installable callback function, see Extending CryptoAPI Functionality.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | wincrypt.h |