PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY función de devolución de llamada (wincrypt.h)
La función de devolución de llamada PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY importa una clave de cifrado de contenido (CEK) ya descifrada. La función PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY se puede instalar mediante un identificador de objeto (OID) cryptography API: Next Generation (CNG).
Sintaxis
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;
BOOL PfnCmsgCngImportContentEncryptKey(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
Parámetros
[in, out] pCNGContentDecryptInfo
Puntero a una estructura de CMSG_CNG_CONTENT_DECRYPT_INFO que se va a actualizar con la CEK importada. Esta estructura contiene toda la información pertinente que se pasa a la función CryptMsgControl .
[in] dwFlags
Este parámetro está reservado. Establézcalo en cero.
pvReserved
Este parámetro está reservado. Establézcalo en NULL.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).
Si se produce un error en la función, el valor devuelto es cero (FALSE). Para obtener información de error extendida, llame a GetLastError.
Si esta función de devolución de llamada no admite el algoritmo de cifrado de claves, debe devolver FALSE y llamar a SetLastError con ERROR_NOT_SUPPORTED.
Comentarios
La función CryptMsgControl llama a esta función para las siguientes operaciones especificadas por su parámetro dwCtrlType :
- CMSG_CTRL_DECRYPT
- CMSG_CTRL_KEY_TRANS_DECRYPT
- CMSG_CTRL_KEY_AGREE_DECRYPT
Puede usar funciones de compatibilidad de OID para implementar esta función de devolución de llamada. Wincrypt.h define la siguiente constante para este propósito.
| Constante | Definición |
|---|---|
| CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC | "CryptMsgDllCNGImportContentEncryptKey" |
Ejemplos
Para obtener un ejemplo en el que se implementa una función de devolución de llamada instalable de OID, consulte Extensión de la funcionalidad cryptoAPI.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wincrypt.h |