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

La función de devolución de llamada PFN_CMSG_IMPORT_MAIL_LIST importa una clave de cifrado de contenido para un destinatario de transporte de claves de un mensaje sobre. PFN_CMSG_IMPORT_MAIL_LIST se puede instalar mediante un identificador de objeto CryptoAPI. La función CryptMsgControl llama a esta función cuando su parámetro dwCtrlType se establece en CMSG_CTRL_DECRYPT.

Sintaxis

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
)
{...}

Parámetros

[in] pContentEncryptionAlgorithm

Puntero a una estructura de CRYPT_ALGORITHM_IDENTIFIER que especifica el algoritmo utilizado para cifrar el contenido del mensaje y los parámetros asociados.

[in] pMailListDecryptPara

Puntero a una estructura de CMSG_CTRL_MAIL_LIST_DECRYPT_PARA que contiene información sobre el destinatario de la lista de distribución de correo.

[in] dwFlags

Este valor no se utiliza. Establézcalo en cero.

pvReserved

Este parámetro está reservado y debe ser NULL.

[out] phContentEncryptKey

Dirección de un identificador de la clave de cifrado de contenido devuelta por esta función.

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 E_NOTIMPL.

Comentarios

Puede usar funciones de compatibilidad de OID para implementar esta función de devolución de llamada. Wincrypt.h define las constantes siguientes para este propósito.

Constante	Definición
CMSG_OID_IMPORT_MAIL_LIST_FUNC o CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC	"CryptMsgDllImportMailList"

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h