PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY función de devolución de llamada (wincrypt.h)

  • Artículo

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

Consulte también

Descodificación de datos sobres