Compartir a través de

IMAPISupport::PrepareSubmit

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

Prepara un mensaje para su envío a la cola MAPI.

HRESULT PrepareSubmit(
LPMESSAGE lpMessage,
ULONG FAR * lpulFlags
);

Parameters

lpMessage

[in] Puntero al mensaje que se va a preparar.

lpulFlags

[entrada, salida] En la entrada, el parámetro lpulFlags está reservado y debe ser cero. En la salida, lpulFlags debe ser NULL.

Valor devuelto

S_OK

El mensaje se preparó correctamente.

Comentarios

El método IMAPISupport::P repareSubmit se implementa para los objetos de soporte técnico del proveedor de mensajes. Los proveedores de almacén de mensajes llaman a PrepareSubmit en su implementación del método IMessage::SubmitMessage para preparar un mensaje para su envío a la cola MAPI.

PrepareSubmit se usa para controlar los mensajes que tienen la marca MSGFLAG_RESEND establecida en su propiedad PR_MESSAGE_FLAGS (PidTagMessageFlags). MSGFLAG_RESEND se establece para los mensajes que incluyen una solicitud que se va a resentir cuando se produce un error en una transmisión inicial. PrepareSubmit determina cuál de los destinatarios de la lista de destinatarios recibió correctamente el mensaje y qué no.

Para acceder a la lista de destinatarios, PrepareSubmit llama al método IMessage::GetRecipientTable del mensaje. Para recuperar los datos del destinatario, PrepareSubmit llama al método IMAPITable::QueryRows de la tabla de destinatarios. Para cada fila de la tabla, PrepareSubmit comprueba la propiedad PR_RECIPIENT_TYPE (PidTagRecipientType) y realiza una de las siguientes acciones:

  • Si se establece la marca de MAPI_SUBMITTED, PrepareSubmit borra la marca y establece la propiedad PR_RESPONSIBILITY (PidTagResponsibility) en FALSE.

  • Si no se establece la marca de MAPI_SUBMITTED, PrepareSubmit cambia PR_RECIPIENT_TYPE a MAPI_P1 y establece PR_RESPONSIBILITY en TRUE.

Notas para los llamadores

Antes de llamar a PrepareSubmit, asegúrese de haber llamado al método IMAPISupport::SpoolerNotify y de establecer la marca NOTIFY_READYTOSEND en el parámetro ulFlags . La llamada a SpoolerNotify debe realizarse una vez por sesión antes de la llamada a PrepareSubmit. SpoolerNotify sincroniza la cola MAPI y garantiza que todos los proveedores de transporte necesarios estén conectados y sus tipos de direcciones estén registrados.

Vea también

IMAPIFolder::GetMessageStatus
IMessage::SubmitMessage
IMAPISupport: IUnknown