4D Doc Center : POP3

4D Internet Commands v14

POP3_GetMessage


POP3_GetMessage ( pop3_ID ; numMsg ; offset ; longitud ; textoMsg ) -> resultado

Parámetro	Tipo	Descripción
pop3_ID	Entero largo	Referencia de una conexión POP3
numMsg	Entero largo	Número del mensaje
offset	Entero largo	Carácter a partir del cual comenzar la recuperación
longitud	Entero largo	Número de caracteres a reenviar
textoMsg	Texto	Texto del mensaje
resultado	Entero	Código de error

Descripción

El comando POP3_GetMessage devuelve el texto completo del mensaje identificado por numMsg en el buzón referenciado por pop3_ID. A menos que se especifique lo contrario por el comando POP3_SetPrefs, se eliminan los caracteres de salto de línea en el mensaje. El comando POP3_GetMessage devuelve todo el mensaje, incluyendo la información de encabezado.

pop3_ID es una referencia entero largo a una sesión abierta creada con POP3_Login.

numMsg es un valor entero largo que indica cual mensaje en el buzón recuperar. numMsg representa la posición de un mensaje dentro de la lista actual de mensajes. El numMsg de un mensaje no es un valor estable, difiere de una sesión a otra en función de las eliminaciones.

offset es un valor entero largo que indica la posición del carácter a partir del cual comenzar la lectura. En la mayoría de los casos pase cero en este parámetro.

El parámetro longitud es un valor entero largo que indica el número de caracteres a recuperar más allá de la posición offset. Dado que la longitud máxima de este parámetro está limitada a 32.000 caracteres por razones históricas, el parámetro longitud debe ser inferior a 32.000. Los mensajes cuyo tamaño sea mayor que 32 K debe recuperarse en el disco utilizando el comando POP3_Download.

textoMsg es una variable texto que recibe el texto recuperado.