smtp_free_ex

Simple Mail Transfer Vuser Functions (SMTP)

Frees the SMTP server for a specific session and cancels all pending commands. .

void smtp_free_ex( SMTP *ppsmtp );
ppsmtpA session identifier.

This function is for use with multiple sessions. For global sessions, use the smtp_free function, which leaves out the session identifier.

Return Values

This function does not return any value.

Parameterization

Standard parameterization is not available for this function.

Example

In the following example, the smtp_free_ex function frees the server from its commands. 

Action()
{
    smtp_logon_ex(&ppsmtp, "Logon",
        "URL=smtp://user0001t@techno.merc–int.com",
        "CommonName=Smtp Test User 0001",
        LAST );
    smtp_send_mail_ex(&ppsmtp, "SendMail",
        "To=user0002t@merc–int.com",
        "Cc=user0003t@merc–int.com",
        "Subject=MIC Smtp: Sample Test",
        "MAILOPTIONS",
        "X–Priority: 3",
        "X–MSMail–Priority: Medium",
        "X–Mailer: Microsoft Outlook Express 5.50.4133.2400\r\n",
        "X–MimeOLE: By Microsoft MimeOLE V5.50.4133.2400\r\n",
        "MAILDATA",
        "MessageText="
            "Content–Type: text/plain;\r\n"
            "\tcharset=\"iso–8859–1\"\r\n"
            "Content–Transfer–Encoding: quoted–printable\r\n"
            "\r\n"
            "Test,\r\n"
            "<HTML><BODY>"
            "<H1><CENTER>PROGRESS UPDATE </CENTER></H1>"
            "</BODY></HTML>\r\n",
        "MessageBlob=16384",
        LAST );
    smtp_free_ex(&ppsmtp );
    smtp_logout_ex(&ppsmtp);
    return 1;
}