Compartir a través de

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

  • Artículo

La función de devolución de llamada PFN_CMSG_EXPORT_MAIL_LIST cifra y exporta la clave de cifrado de contenido para un destinatario de la lista de correo de un mensaje sobre. PFN_CMSG_EXPORT_MAIL_LIST se puede instalar mediante un (OID) de CryptoAPI. La función CryptMsgOpenToEncode llama a esta función cuando su parámetro dwMsgType se establece en CMSG_ENVELOPED.

Sintaxis

PFN_CMSG_EXPORT_MAIL_LIST PfnCmsgExportMailList;

BOOL PfnCmsgExportMailList(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO pMailListEncodeInfo,
  [in, out] PCMSG_MAIL_LIST_ENCRYPT_INFO pMailListEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parámetros

[in] pContentEncryptInfo

Puntero a una estructura de CMSG_CONTENT_ENCRYPT_INFO que contiene la clave de cifrado de contenido.

[in] pMailListEncodeInfo

Puntero a una estructura de CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO que especifica la clave utilizada para cifrar la clave de cifrado de contenido.

[in, out] pMailListEncryptInfo

Puntero a una estructura de CMSG_MAIL_LIST_ENCRYPT_INFO que contiene la clave de cifrado de contenido cifrada.

[in] dwFlags

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

pvReserved

Este parámetro está reservado y debe ser 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.

Observaciones

La función PFN_CMSG_EXPORT_MAIL_LIST debe actualizar el miembro EncryptedKey de la estructura CMSG_MAIL_LIST_ENCRYPT_INFO a la que apunta el parámetro pMailListEncryptInfo. Esta función debe usar los miembros de pfnAlloc y pfnFree de la estructura de CMSG_CONTENT_ENCRYPT_INFO a la que apunta el parámetro pContentEncryptInfo para administrar la memoria de los valores que actualiza.

Puede usar funciones de compatibilidad con 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_EXPORT_MAIL_LIST_FUNC o CMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC "CryptMsgDllExportMailList"

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wincrypt.h