IMsgStore::FinishedMsg
Hace referencia a: Outlook 2013 | Outlook 2016
Permite que el proveedor del almacén de mensajes realice el procesamiento en un mensaje enviado. Se llama a este m�todo s�lo por la cola MAPI.
HRESULT FinishedMsg(
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parameters
ulFlags
[entrada] Reservado; debe ser cero.
cbEntryID
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpEntryID .
lpEntryID
[in] Puntero al identificador de entrada del mensaje que se va a procesar.
Valor devuelto
S_OK
El procesamiento en el mensaje enviado se realizó correctamente.
MAPI_E_NO_SUPPORT
El proveedor del almacén de mensajes no admite el procesamiento de mensajes enviados. Este valor de error se devuelve si el autor de la llamada no es la cola MAPI.
Comentarios
El método IMsgStore::FinishedMsg realiza el procesamiento en un mensaje enviado. Este procesamiento puede implicar la eliminación del mensaje, su traslado a una carpeta diferente o ambas acciones. El tipo de procesamiento depende de si se establecen las propiedades PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) y PR_SENTMAIL_ENTRYID (PidTagSentMailEntryId).
Notas a los implementadores
En la implementación de FinishedMsg, desbloquee el mensaje identificado por lpEntryID y realice el procesamiento adecuado. El mensaje de destino siempre se bloqueará; la cola MAPI nunca pasa el identificador de entrada de un mensaje desbloqueado a FinishedMsg.
Es posible que no se establezca ni PR_DELETE_AFTER_SUBMIT ni PR_SENTMAIL_ENTRYID , se establezcan ambos o se establezca uno u otro. En la tabla siguiente se describe la acción que debe realizar en función de la configuración:
| Propiedad | Valor |
|---|---|
| Si no se establece ninguna de las propiedades: |
Deje el mensaje en la carpeta desde la que se envió (normalmente, la Bandeja de salida). |
| Si se establecen ambas propiedades: |
Mueva el mensaje a la carpeta indicada, si lo desea, y elimínelo. |
| Si se establece PR_SENTMAIL_ENTRYID: |
Mueva el mensaje a la carpeta indicada. |
| Si PR_DELETE_AFTER_SUBMIT está establecido: |
Elimine el mensaje. |
Después de realizar cualquier acción adecuada, llame al método IMAPISupport::D oSentMail .