IMessage::DeleteAttach
Hace referencia a: Outlook 2013 | Outlook 2016
Elimina los datos adjuntos.
HRESULT DeleteAttach(
ULONG ulAttachmentNum,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parameters
ulAttachmentNum
[in] Número de índice de los datos adjuntos que se van a eliminar. Este es el valor de la propiedad PR_ATTACH_NUM (PidTagAttachNumber) de los datos adjuntos.
ulUIParam
[in] Controle en la ventana primaria de los cuadros de diálogo o ventanas que muestra este método. El parámetro ulUIParam se omite a menos que se establezca la marca de ATTACH_DIALOG en el parámetro ulFlags .
lpProgress
[in] Puntero a un objeto de progreso que muestra un indicador de progreso. Si se pasa NULL en lpProgress, el proveedor del almacén de mensajes muestra un indicador de progreso mediante la implementación del objeto de progreso MAPI. El parámetro lpProgress se omite a menos que la marca de ATTACH_DIALOG se establezca en ulFlags.
ulFlags
[in] Máscara de bits de marcas que controla la visualización de una interfaz de usuario. Se puede establecer la marca siguiente:
ATTACH_DIALOG
Solicita la visualización de un indicador de progreso a medida que avanza la operación.
Valor devuelto
S_OK
Los datos adjuntos se eliminaron correctamente.
Comentarios
El método IMessage::D eleteAttach elimina los datos adjuntos de dentro de un mensaje.
Los datos adjuntos eliminados no se eliminan permanentemente hasta que se llama al método IMAPIProp::SaveChanges del mensaje.
Notas para los llamadores
Antes de llamar a DeleteAttach, llame al método IUnknown::Release para los datos adjuntos y cada una de sus secuencias.
Dado que la eliminación de datos adjuntos puede ser un proceso largo, DeleteAttach proporciona el mecanismo que muestra un indicador de progreso. Para solicitar la visualización de un indicador de progreso, pase un puntero a la implementación IMAPIProgress: IUnknown o NULL si no tiene una implementación. También debe especificar un identificador de ventana en el parámetro ulUIParam y la marca ATTACH_DIALOG en el parámetro ulFlags .
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| AttachmentsDlg.cpp |
CAttachmentsDlg::OnDeleteSelectedItem |
MFCMAPI usa el método IMessage::D eleteAttach para eliminar los datos adjuntos seleccionados. |