4D Doc Center : MSG

4D Internet Commands v14

MSG_GetMessage


MSG_GetMessage ( nomeArquivo ; offset ; longitude ; textoBruto ) -> Resultado

Parâmetro	Tipo	Descrição
nomeArquivo	Texto	Nome de arquivo
offset	Inteiro longo	Inicio do offset no arquivo da mensagem (0= inicio do arquivo)
longitude	Inteiro longo	Número de caracteres
textoBruto	Texto	Texto bruto (ignora as Prefs)
Resultado	Inteiro	Código de erro

Descrição

O comando MSG_GetMessage devolve o texto sem formato da mensagem independentemente dos dados adjuntos. Não elimina os cabeçalhos MIME.

nomeArquivo é o nome ou a rota de acesso completa do arquivo do qual extrair o corpo da mensagem. Se só passa um nome de arquivo, a rota de acesso por padrão será a da pasta definida por POP3_SetPrefs ou MSG_SetPrefs (ver Nota de compatibilidade). Se não é especificada nenhuma pasta, a rota por padrão será a pasta que contém a estrutura da base.

Nota de compatibilidade (versão 6.8.1): se não é utilizado o comando MSG_SetPrefs, é levado em conta o parâmetro pastaMsg definida pelo comando POP3_SetPrefs; se é utilizado MSG_SetPrefs, o parâmetro definido pelo comando POP3_SetPrefs é ignorado.

O parâmetro offset permite definir, na mensagem fonte, a posição do caractere a partir da qual começar a recuperação.

O parâmetro longitude é o número de caracteres a devolver.

O parâmetro textoBruto recebe todo o texto da mensagem. São ignorados os parâmetros das preferências para a eliminação dos retornos de linha e os possíveis documentos adjuntos no corpo da mensagem não são eliminados.