IMAPISupport::CopyMessages
Aplica-se a: Outlook 2013 | Outlook 2016
Copia ou move mensagens de uma pasta para outra pasta.
HRESULT CopyMessages(
LPCIID lpSrcInterface,
LPVOID lpSrcFolder,
LPENTRYLIST lpMsgList,
LPCIID lpDestInterface,
LPVOID lpDestFolder,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parâmetros
lpSrcInterface
[in] Um ponteiro para o IID (identificador de interface) que representa a interface a ser usada para acessar a pasta que contém as mensagens a serem copiadas ou movidas.
lpSrcFolder
[in] Um ponteiro para a pasta que contém as mensagens a serem copiadas ou movidas.
lpMsgList
[in] Um ponteiro para uma matriz de identificadores de entrada que identificam as mensagens a serem copiadas ou movidas.
lpDestInterface
[in] Um ponteiro para o IID (identificador de interface) que representa a interface a ser usada para acessar a pasta de destino das mensagens copiadas ou movidas.
lpDestFolder
[in] Um ponteiro para a pasta de destino das mensagens copiadas ou movidas. Essa pasta deve estar aberta.
ulUIParam
[in] Um ponteiro para um objeto de progresso que exibe um indicador de progresso. Se NULL for passado em lpProgress, o provedor do repositório de mensagens exibirá um indicador de progresso usando a implementação do objeto de progresso MAPI. O parâmetro lpProgress é ignorado, a menos que o sinalizador MESSAGE_DIALOG seja definido em ulFlags.
lpProgress
[in] Um ponteiro para um objeto de progresso que exibe um indicador de progresso. Se NULL for passado em lpProgress, o provedor do repositório de mensagens exibirá um indicador de progresso usando a implementação do objeto de progresso MAPI. O parâmetro lpProgress é ignorado, a menos que o sinalizador MESSAGE_DIALOG seja definido em ulFlags.
ulFlags
[in] Um bitmask de sinalizadores que controla como a operação de cópia ou movimentação é realizada. Os seguintes sinalizadores podem ser definidos:
MESSAGE_DIALOG
Solicita a exibição de um indicador de progresso.
MESSAGE_MOVE
As mensagens devem ser movidas, em vez de copiadas. Se MESSAGE_MOVE não estiver definido, as mensagens serão copiadas.
Valor de retorno
S_OK
A operação de cópia ou movimentação foi bem-sucedida.
MAPI_E_USER_CANCEL
O usuário cancelou a operação, normalmente clicando no botão Cancelar em uma caixa de diálogo.
Comentários
O método IMAPISupport::CopyMessages é implementado para objetos de suporte do provedor do repositório de mensagens. Os provedores do repositório de mensagens podem chamar IMAPISupport::CopyMessages na implementação de IMAPIFolder::CopyMessages para copiar ou mover uma ou mais mensagens de uma pasta para outra. Como parte da chamada IMAPISupport::CopyMessages , o provedor do repositório de mensagens pode especificar que o MAPI deve exibir um indicador de progresso.