4D Doc Center : MSG

4D Internet Commands v14

MSG_GetHeaders


MSG_GetHeaders ( nomeArquivo ; offset ; longitude ; textoCabe ) -> Resultado

Parâmetro	Tipo	Descrição
nomeArquivo	Texto	Nome de arquivo
offset	Inteiro longo	Inicio do offset na seção de cabeçalhos(0= inicio do cabeçalho)
longitude	Inteiro longo	Número de caracteres
textoCabe	Texto	Texto do cabeçalho (elimina os retornos de linha se Prefs estão ativadas)
Resultado	Inteiro	Código de erro

Descrição

O comando MSG_GetHeaders devolve o texto bruto da seção de cabeçalho da mensagem. O cabeçalho de uma mensagem POP3 se define como o texto do princípio da mensagem até a primeira ocorrência de duas sequências consecutivas de retorno de carro/retorno linha.

nomeArquivo é o nome ou a rota de acesso completa do arquivo do qual extrair o cabeçalho. Se só é dado 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 offset permite definir, no corpo, a posição do caractere a partir do qual começar a recuperação.

O parâmetro longitude é o número de caracteres a devolver. A longitude da seção de cabeçalho pode ser determinada com MSG_MessageSize.

O parâmetro textoCabe recebe o texto do cabeçalho. Este parâmetro leva em conta o valor do parâmetro retornoLinha definido por POP3_SetPrefs ou MSG_SetPrefs.

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