IMAPISupport::CopyMessages
Hace referencia a: Outlook 2013 | Outlook 2016
Copia o mueve mensajes de una carpeta a otra.
HRESULT CopyMessages(
LPCIID lpSrcInterface,
LPVOID lpSrcFolder,
LPENTRYLIST lpMsgList,
LPCIID lpDestInterface,
LPVOID lpDestFolder,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parameters
lpSrcInterface
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder a la carpeta que contiene los mensajes que se van a copiar o mover.
lpSrcFolder
[in] Puntero a la carpeta que contiene los mensajes que se van a copiar o mover.
lpMsgList
[in] Puntero a una matriz de identificadores de entrada que identifican los mensajes que se van a copiar o mover.
lpDestInterface
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder a la carpeta de destino de los mensajes copiados o movidos.
lpDestFolder
[in] Puntero a la carpeta de destino de los mensajes copiados o movidos. Esta carpeta debe estar abierta.
ulUIParam
[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 MESSAGE_DIALOG se establezca en 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 MESSAGE_DIALOG se establezca en ulFlags.
ulFlags
[in] Máscara de bits de marcas que controla cómo se realiza la operación de copia o movimiento. Se pueden establecer las siguientes marcas:
MESSAGE_DIALOG
Solicita la visualización de un indicador de progreso.
MESSAGE_MOVE
Los mensajes deben moverse, en lugar de copiarse. Si no se establece MESSAGE_MOVE, se copian los mensajes.
Valor devuelto
S_OK
La operación de copia o movimiento se realizó correctamente.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo.
Comentarios
El método IMAPISupport::CopyMessages se implementa para los objetos de soporte técnico del proveedor de mensajes. Los proveedores de almacén de mensajes pueden llamar a IMAPISupport::CopyMessages en su implementación de IMAPIFolder::CopyMessages para copiar o mover uno o varios mensajes de una carpeta a otra. Como parte de la llamada IMAPISupport::CopyMessages , el proveedor del almacén de mensajes puede especificar que MAPI debe mostrar un indicador de progreso.