wiki:es:Documentation/ARexxAPI/MAILINFO

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

--

En otros idiomas:


ARexx API

    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 ?