4D Doc Center : POP3

4D Internet Commands v14

POP3_DownLoad


POP3_DownLoad ( pop3_ID ; numMsg ; cabeApenas ; nomeArquivo ) -> Resultado

Parâmetro	Tipo	Descrição
pop3_ID	Inteiro longo	Referencia de uma conexão POP3
numMsg	Inteiro longo	Número da mensagem
cabeApenas	Inteiro	0 = Mensagem inteiro, 1 = Cabeçalho unicamente
nomeArquivo	Texto	Nome do arquivo local
		Nome do arquivo local utilizado
Resultado	Inteiro	Código de erro

Descrição

O comando POP3_DownLoad está desenhado para recuperar uma mensagem de um servidor POP3 mediante o download em um arquivo em disco. Toda mensagem POP3 que contenha arquivos adjuntos ou cujo tamanho seja maior que 32K deve ser baixado com este comando. Os arquivos adjuntos só podem ser extraídos das mensagens recuperadas desta forma.

pop3_ID é uma referencia inteiro longo a uma sessão aberta criada com POP3_Login.

numMsg é um valor inteiro longo que indica qual mensagem na caixa de correio recuperar. numMsg representa a posição de uma mensagem dentro da lista atual de mensagens. O numMsg de uma mensagem não é um valor estável, difere de uma sessão a outra em função das eliminações.

cabeApenas é um valor inteiro que indica se deve recuperar toda mensagem ou só a informação do cabeçalho.

nomeArquivo contém o nome do arquivo e a via de acesso opcional onde deseja guardar a mensagem. Este valor pode ser especificado de três formas diferentes:

""	= Guarda o arquivo na pasta definida por POP3_SetPrefs, com o nome "temp1" (se um arquivo com o mesmo nome existente, é provado com os nomes "temp2", "temp3", etc.)
"nomeArquivo"	= Guarda o arquivo na pasta definida por POP3_SetPrefs, com o nome nomeArquivo
"Via:nomeArquivo"	= Guarda o arquivo na via especificada por nomeArquivo

Nos dois primeiros casos, se POP3_SetPrefs, não especifica nenhuma pasta, a mensagem será guardada na mesma pasta que a estrutura do banco de dados (com 4D autônomo) ou na pasta 4D Client (com 4D Server). Depois de que o arquivo é guardado no disco, o nome final do arquivo é devolvido no parâmetro nomeArquivo. Se tenta chamar a POP3_Download com um nomeArquivo que já existe na pasta de download, o nome se incrementa numericamente e seu novo valor como é guardado no disco será devolvido à variável nomeArquivo.