4D Doc Center : SMTP

4D v13.2

SMTP_Attachment


SMTP_Attachment ( smtp_ID ; nomeArquivo ; tipoCod ; excluirOpcao ) -> Resultado

Parâmetro	Tipo	Descrição
smtp_ID	Inteiro longo	Referencia da mensagem
nomeArquivo	Texto	Nome do arquivo a anexar
tipoCod	Inteiro	0 = Não codificar (só envia o DataFork) ±1 = BinHex ±2 = Base64; (só envia o DataFork) ±3 = AppleSingle ±4 = AppleDouble ±5 = AppleSingle E Base64 ±6 = AppleDouble E Base64 ±7 = UUEncode
excluirOpcao	Inteiro	0 = Adicionar à lista existente, 1 = Substituir todos os anexos por nomeArquivo, 2 = Excluir somente este anexo
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_Attachment permite adicionar arquivos binários ou de texto a sua mensagem em formato MIME. Este comando pode ser chamado várias vezes para anexar vários documentos a uma mensagem. Se passa um valor maior que zero no parâmetro tipoCod, este comando realizará a codificação no momento do envio da mensagem.

smtp_ID é a referencia inteiro longo de uma mensagem criado com o comando SMTP_New.

nomeArquivo contém o nome do arquivo a anexar a mensagem. Este valor pode ser especificado de três formas diferentes:

""	= Mostra a caixa de diálogo estandarte de abertura de documentos.
"nomeArquivo"	= Procura o nome do arquivo no mesmo diretório que a estrutura do banco de dados.
"Via:nomeArquivo"	= Via de acesso completa incluindo o nome de arquivo.

tipoCod é um valor inteiro que indica que tipo de codificação aplicar ao arquivo antes de integrar a mensagem. Se anexa um arquivo binário, deve utilizar um método de codificação adequado (BinHex, AppleSingle). O método de codificação mais comum é BinHex.

Se passar valores positivos em tipoCod o comando codifica automaticamente o arquivo utilizando o método especificado quando é enviada a mensagem. A codificação de um arquivo se produz no momento em que é executado o comando SMTP_Send. Se o arquivo é grande a execução do comando SMTP_Send pode demorar uns momentos. Pode economizar tempo quando o mesmo arquivo se envia várias vezes. Nestes casos o melhor é codificar o arquivo uma vez com o comando IT_Encode e depois anexar o arquivo resultante a sua mensagem utilizando o valor negativo de tipoCod. Um valor negativo em tipoCod não realizará nenhuma codificação adicional, mas que o tipo de codificação é descrito no cabeçalho do arquivo adjunto à mensagem. Isto informa ao software de mensagens do destinatário a forma correta de interpretar os dados anexos.

Nota: Não pode passar um elemento de array no parâmetro tipoCod.

excluirOpcao é um parâmetro inteiro opcional que especifica a forma de tratar os dados adjuntos.

Um valor de zero adiciona o arquivo anexo à lista atual dos arquivos adjuntos.
Um valor de 1 substitui todos os arquivos anexos com o arquivo nomeArquivo. Se nomeArquivo é uma cadeia vazia, todos os arquivos anexos serão excluídos.
Um valor de 2 eliminará somente o arquivo adjunto listado em nomeArquivo da lista de arquivos anexos.