wiki:es:Documentation/ARexxAPI/MAILINFO

Version 1 (modified by AmigaPhil, 13 months ago) (diff)

--

En otros idiomas:

MAILINFO

NOMBRE

MailInfo -- Obtener información sobre un mensaje. (V2.0)

PLANTILLA

VAR/K,STEM/K,INDEX/N

FUNCIÓN

Devuelve información sobre un mensaje de la carpeta, o sobre el mensaje actual si no especifica ninguno.

ENTRADAS

VAR/K - variable alternativa en la que almacenar los resultados en lugar de RESULT
STEM/K - nombre base usado para los STEMs donde se almacenará la información devuelta
INDEX/N - posición del mensaje del que se quiere obtener información, donde el primer mensaje de la carpeta ocupa la posición 0; si no se indica índice alguno, se utilizará el mensaje actual

RESULTADOS

VAR - información devuelta por el comando
<STEM>INDEX - posición del mensaje en la carpeta; el primer mensaje de la misma ocupa la posición 0
<STEM>STATUS - estado del mensaje; los valores posibles son

N - nuevo
O - leído
U - no leído
R - respondido
F - reenviado
S - enviado
W - listo para enviar
H - retenido
E - envío fallido

<STEM>FROM - remitente del mensaje, o más exactamente el primer remitente que figura en la cabecera "From:"
<STEM>TO - destinatario del mensaje, o más exactamente el primero que figura en la cabecera "To:"
<STEM>REPLYTO - dirección de retorno del mensaje, o más exactamente el primer destinatario que figura en la cabecera "Reply-To:", o en su defecto el primer remitente de la cabecera "From:"
<STEM>SUBJECT - asunto del mensaje (contenido de la cabecera "Subject:")
<STEM>FILENAME - fichero donde se encuentra el mensaje, incluyendo la senda
<STEM>SIZE - tamaño del mensaje, en bytes
<STEM>DATE - fecha del mensaje, en el formato "MM-DD-AA HH:MM:SS"
<STEM>FLAGS - una cadena de 9 bytes en el formato "MARCS-77M":

MARCS-77M
||||| |||
||||| ||`--------- bandera Marcado (V2.4)
||||| |`---------- bandera volátil (véase SETFLAG ?)
||||| `----------- bandera permanente (véase SETFLAG ?)
||||`------------- firmado con PGP
|||`-------------- enCriptado con PGP
||`--------------- infoRme de estado
|`---------------- contiene Anexos
`----------------- Múltiples destinatarios

<STEM>MSGID - representación hexadecimal comprimida en 32 bits del contenido de la cabecera "Message-ID:", por ejemplo BBC62595 (V2.1)

RC se pone a 10 si INDEX está fuera del rango de mensajes disponibles en la carpeta.

NOTAS

A partir de YAM 2.4, <STEM>MSGID devuelve un valor hexadecimal.

EJEMPLO

/* Activar códigos de resultados */

OPTIONS RESULTS

/* Obtener información sobre el mensaje actual */

MAILINFO STEM st.

/* Mostrar los resultados */

SAY 'Mensaje: 'st.index
status = st.status
SELECT

WHEN status = 'N' THEN status = 'Nuevo'
WHEN status = 'O' THEN status = 'Leído'
WHEN status = 'U' THEN status = 'No leído'
WHEN status = 'R' THEN status = 'Respondido'
WHEN status = 'F' THEN status = 'Reenviado'
WHEN status = 'S' THEN status = 'Enviado'
WHEN status = 'W' THEN status = 'Listo para enviar'
WHEN status = 'H' THEN status = 'Retenido'
OTHERWISE status = 'Envío fallido'

END
SAY 'Estado: 'status
SAY 'De: 'st.from
SAY 'Para: 'st.to
SAY 'Contestar a: 'st.replyto
SAY 'Asunto: 'st.subject
SAY 'Fichero: 'st.filename
SAY 'Tamaño: 'st.size
SAY 'Fecha: 'st.date
SAY 'Banderas: 'st.flags
SAY 'Message-ID: 'st.msgid

FALLOS

En la V2.3p1, <STEM>FILENAME omitía la parte del nombre de la carpeta cuando no se indicaba un índice. Esto fue corregido en YAM 2.4.

VÉASE TAMBIÉN

SETFLAG ?