IXPLogon::EndMessage
Hace referencia a: Outlook 2013 | Outlook 2016
Informa al proveedor de transporte de que la cola MAPI completó su procesamiento en un mensaje saliente.
HRESULT EndMessage(
ULONG ulMsgRef,
ULONG FAR * lpulFlags
);
Parameters
ulMsgRef
[in] Valor de referencia específico del mensaje que se obtuvo en una llamada anterior al método IXPLogon::SubmitMessage .
lpulFlags
[out] Máscara de bits de marcas que indica a la cola MAPI lo que debe hacer con el mensaje. Si no se establece ninguna marca, se ha enviado el mensaje. Se pueden establecer las siguientes marcas:
END_DONT_RESEND
El proveedor de transporte tiene toda la información que necesita sobre este mensaje por ahora. Cuando el proveedor de transporte requiere más información o cuando ha enviado el mensaje, notifica a la cola MAPI llamando al método IMAPISupport::SpoolerNotify con la marca NOTIFY_SENTDEFERRED y pasando el identificador de entrada del mensaje.
END_RESEND_LATER
El proveedor de transporte no envía el mensaje en el momento actual por motivos que no son condiciones de error. Se debe volver a llamar al proveedor de transporte más adelante para enviar el mensaje.
END_RESEND_NOW
El proveedor de transporte debe reiniciar el mensaje que se le ha pasado en una llamada al método IMessage::SubmitMessage .
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
Comentarios
La cola MAPI llama al método IXPLogon::EndMessage después de completar el procesamiento implicado en la entrega extendida o la información de no entrega.
Una vez que se devuelve esta llamada, el valor del parámetro ulMsgRef ya no es válido para este mensaje. El proveedor de transporte puede reutilizar el mismo valor en un mensaje futuro.
Todos los objetos que abre el proveedor de transporte durante la transferencia de un mensaje deben liberarse antes de que se devuelva la llamada a EndMessage , con la excepción del objeto de mensaje que la cola MAPI pasa al proveedor de transporte. El objeto de mensaje pasado por la cola MAPI no es válido después de la llamada a EndMessage .