4D Doc Center : MSG

4D Internet Commands v14

MSG_Extract


MSG_Extract ( nomeArquivo ; decode ; pastaAttach ; listaAdj ) -> Resultado

Parâmetro	Tipo	Descrição
nomeArquivo	Texto	Nome do arquivo (o caminho padrão é a pasta de mensagem)
decode	Inteiro	0 = Não decodificar, 1 = Decodificar caso seja possível
pastaAttach	Texto	Via da pasta (via por padrão na pasta attachment)
listaAdj	Array cadeia	Nome de arquivos adjuntos (sem via de acesso)
Resultado	Inteiro	Código de erro

Descrição

O comando MSG_Extract extrai todos os arquivos adjuntos e os coloca na pasta de arquivos adjuntos.

nomeArquivo é o nome ou a rota de acesso completa do arquivo do qual extrair os arquivos adjuntos. Se só se dá um nome de arquivo, a rota de acesso por padrão será a da pasta definida por POP3_SetPrefs ou MSG_SetPrefs (ver a nota de compatibilidade). Se nenhuma pasta foi especificada, a rota por padrão será a da pasta que contém a estrutura do banco de dados (com 4D monousuário) ou a da pasta 4D Client (com 4D Server).

O parâmetro decode especifica se deve tentar decodificar o arquivo adjunto. Um valor de zero indica que não se deve tentar decodificar o arquivo adjunto. Um valor de 1 tratará de decodificar o arquivo se foi codificado em uma das seguintes formas: BinHex, AppleSingle, AppleDouble, ou Base64.

pastaAttach indica a rota de acesso aonde guardar o arquivo adjunto. Se passada uma cadeia vazia, o arquivo será guardado na pasta de arquivos adjuntos especificada por POP3_SetPrefs ou MSG_SetPrefs (ver a nota de compatibilidade). Se não é especificada a pasta, o arquivo adjunto se guarda na mesma pasta que a estrutura de banco de dados.

Nota de compatibilidade (versão 6.8.1): se o comando MSG_SetPrefs não se utiliza, se leva em conta os parâmetros pastaMsg e rotaDocsAdj do comando POP3_SetPrefs; se é utilizado MSG_SetPrefs, os parâmetros pastaMsg e rotaDocsAdj do comando POP3_SetPrefs são ignorados.

listaAdj é um array alfanumérico/texto que se devolve com os nomes dos arquivos de cada arquivo adjunto. Só o nome do documento será devolvido em cada elemento do array, sem a rota de acesso.