	Sign In Sign-Up

Tcp4u - SMTP related functions

SmtpSendMessage

SmtpSendMessage

This function sends a text string using the SMTP protocol such as described by the RFC 821.
Notes:

The use of this function requires a previous call to Tcp4uInit().
Several addressees can be specified into the szTo argument. They should be separated by a semi-colon sign.
If at least one address is invalid (ie: rejected by the server), the functions returns without sending any data.
The headers (ie: strings like Reply-To:, Subject:, CC:, ...) should be included at the beginning of the szMessage argument. SmtpSendMessage() only add its X-Mailer: header.
The function uses the smtp port such as mentioned in the file services. By default, it uses the port 25.
A successful return code does not warranty the delivery of the message, just that if the delivery fails, the sender will receive a notification.

Syntax:            SmtpSendMessage (LPCSTR szFrom, 
                                    LPCSTR szTo, 
                                    LPCSTR szMessage, 
                                    LPCSTR szServer,
                                    LPCSTR szLocalDomain)

Arguments:

szFrom	The SMTP address of the sender
szTo	The addressees. They should be separated by semi-colons.
szMessage	The message to be sent.
szServer	The local SMTP server.
szLocalDomain	The local domain name. If no domain is to be precised, this argument should be set NULL

Returns:

SMTP4U_UNEXPECTEDANSWER	This answer is not mentioned into the RFC
SMTP4U_SERVICECLOSED	Server has closed connection: service unavailable
SMTP4U_NOTIMPLEMENTED	Command not implemented
SMTP4U_MIMENOTSUPPORTED	8-bits extension not supported by this server
SMTP4U_SERVERCANTEXECUTE	The Server refused the command
SMTP4U_CANTCONNECT	Tcp4u can not establish a session with the specified server on the smtp port
SMTP4U_DATAERROR	Various network errors
SMTP4U_SYNTAXERROR	The sent command is rejected by the server. Bad arguments.
SMTP4U_STORAGEEXCEDED	Addressee's mailbox is full
SMTP4U_UNKNOWNUSER	User is unknown or address is invalid
SMTP4U_SUCCESS	Message is now managed by the server


Example :
    SmtSendMessage ("me@mydomain.net", "ark@foo.net; evan@xyz.net; me",
                    "Subject: Hello\r\nHello guys", "smtp.mydomain.net",
                    "mydomain.net");

Tcp4u version 3.31 by Ph. Jounin and Laurent Le Bras

Last updated: 10th march 1998