4D Doc Center : MSG

4D Internet Commands v14

MSG_FindHeader


MSG_FindHeader ( nomeArquivo ; etiqCabe ; valorCabe ) -> Resultado

Parâmetro	Tipo	Descrição
nomeArquivo	Texto	Nome do arquivo
etiqCabe	cadeia	Etiqueta do cabeçalho("De:", "Para:", "Assunto:", etc.)
valorCabe	Texto	Valor
Resultado	Inteiro	Código de erro

Descrição

Dado o nomeArquivo de um documento de mensagem recuperado no disco pelo comando POP3_Download ou IMAP_Download, o comando MSG_FindHeader buscará a seção de cabeçalho de etiqCabe e devolver o valor assinalado ao campo em valorCabe.

nomeArquivo é o nome ou rota de acesso completo do arquivo do qual extrair a informação do cabeçalho. Se somente é dado 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 nenhuma pasta foi especificada por POP3_SetPrefs, a rota por padrão será a da pasta que contém a estrutura do banco de dados (com 4D monousuário) ou a pasta de 4D Client (com 4D Server).

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 terá em conta. Se o comando MSG_SetPrefs se utiliza, o parâmetro definido pelo comando POP3_SetPrefs se ignora.

etiqCabe é uma cadeia que contém o nome da etiqueta de cabeçalho. etiqCabe pode fazer referencia a todo cabeçalho definido, especificado pelo usuário ou estendido, tal como "De:", "Para:", "X-MeuCabeçalho", etc.

valorCabe é uma variável de texto onde o comando devolverá o valor assinalado ao campo de cabeçalho especificado. Dado que o parâmetro valorCabe pode incluir caracteres estendidos, pode automatizar sua gestão com o comando POP3_Charset ou MSG_Charset.

Nota de compatibilidade (versão 6.8.1): se o comando MSG_Charset não se utiliza, o parâmetro conjCorpos definido pelo comando POP3_Charset se utilizará. Se é utilizado o comando MSG_Charset, o parâmetro definido pelo comando POP3_Charset é ignorado.