Função de retorno de chamada MAPISENDDOCUMENTS (mapi.h)

[O uso dessa função não é recomendado. Ele pode estar alterado ou indisponível em versões subsequentes do Windows.]

A função MAPISendDocuments envia uma mensagem padrão com um ou mais arquivos anexados e uma anotação de capa. A nota de capa é uma caixa de diálogo que permite que o usuário insira uma lista de destinatários e uma mensagem opcional. MAPISendDocuments difere da função MAPISendMail , pois permite menos flexibilidade na geração de mensagens.

Sintaxe

MAPISENDDOCUMENTS Mapisenddocuments;

ULONG Mapisenddocuments(
  [in] ULONG_PTR ulUIParam,
  [in] LPSTR lpszDelimChar,
  [in] LPSTR lpszFilePaths,
  [in] LPSTR lpszFileNames,
       ULONG ulReserved
)
{...}

Parâmetros

[in] ulUIParam

Identificador de janela pai ou zero, indicando que, se uma caixa de diálogo for exibida, ela será modal do aplicativo. Se o parâmetro ulUIParam contiver um identificador de janela pai, ele será do tipo HWND (convertido em um ULONG_PTR). Se nenhuma caixa de diálogo for exibida durante a chamada, ulUIParam será ignorado.

[in] lpszDelimChar

Ponteiro para um caractere que o chamador usa para delimitar os nomes apontados pelos parâmetros lpszFullPaths e lpszFileNames . O chamador deve selecionar um caractere para o delimitador que não é usado em nomes de arquivo do sistema operacional.

[in] lpszFilePaths

Ponteiro para uma cadeia de caracteres que contém uma lista de caminhos completos (incluindo letras de unidade) para arquivos de anexo. Essa lista é formada pela concatenação de caminhos de arquivo formados corretamente separados pelo caractere especificado no parâmetro lpszDelimChar e seguidos por um terminador nulo . Um exemplo de uma lista válida é:

C:\TMP\TEMP1.DOC;C:\TMP\TEMP2.DOC

Os arquivos especificados nesse parâmetro são adicionados à mensagem como anexos de arquivo. Se esse parâmetro for NULL ou contiver uma cadeia de caracteres vazia, a caixa de diálogo Enviar Anotação será exibida sem arquivos anexados.

[in] lpszFileNames

Ponteiro para uma lista terminada em nulo dos nomes de arquivo originais, pois eles devem aparecer na mensagem. Quando vários nomes são especificados, a lista é formada concatenando os nomes de arquivo separados pelo caractere especificado no parâmetro lpszDelimChar e seguido por um terminador nulo . Um exemplo é:

TEMP3.DOC;TEMP4.DOC

Se não houver nenhum valor para o parâmetro lpszFileNames ou se ele estiver vazio, MAPISendDocuments definirá os nomes de arquivo definidos como os valores de nome de arquivo indicados pelo parâmetro lpszFullPaths .

ulReserved

Reservados; deve ser zero.

Retornar valor

Essa função retorna um dos valores a seguir.

Código de retorno	Descrição
MAPI_E_ATTACHMENT_OPEN_FAILURE	Não foi possível localizar um ou mais arquivos no parâmetro lpszFilePaths . Nenhuma mensagem foi enviada.
MAPI_E_ATTACHMENT_WRITE_FAILURE	Não foi possível gravar um anexo em um arquivo temporário. Verifique as permissões de diretório.
MAPI_E_FAILURE	Um ou mais erros não especificados ocorreram ao enviar a mensagem. Não se sabe se a mensagem foi enviada.
MAPI_E_INSUFFICIENT_MEMORY	Não havia memória suficiente para continuar.
MAPI_E_LOGIN_FAILURE	Não havia logon padrão e o usuário não conseguiu fazer logon com êxito quando a caixa de diálogo de logon foi exibida. Nenhuma mensagem foi enviada.
MAPI_E_USER_ABORT	O usuário cancelou uma das caixas de diálogo. Nenhuma mensagem foi enviada.
SUCCESS_SUCCESS	A chamada foi bem-sucedida e a mensagem foi enviada.

Comentários

A função MAPISendDocuments envia uma mensagem padrão, sempre exibindo uma caixa de diálogo de anotação de capa para que o usuário possa fornecer destinatários e outras opções de envio. Essa função tenta estabelecer uma sessão usando a sessão compartilhada do sistema de mensagens. Se nenhuma sessão compartilhada existir, ela solicitará ao usuário informações de logon para estabelecer uma sessão. Antes que MAPISendDocuments retorne, ele encerra a sessão.

Os anexos de mensagem podem incluir o documento ativo ou todos os documentos abertos no momento no aplicativo cliente chamado MAPISendDocuments. Essa função é usada principalmente para chamadas de uma macro ou linguagem de script, geralmente encontrada em aplicativos como planilha ou programas de processamento de palavras.

MAPISendDocuments cria quantos anexos de arquivo houver caminhos especificados pelo parâmetro lpszFullPaths , apesar do fato de que pode haver diferentes números de caminhos e nomes de arquivo. O chamador é responsável por excluir arquivos temporários criados ao usar MAPISendDocuments.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	mapi.h

Confira também

MAPISendMail

MAPI simples