1.2.1.NET Framework

The MT4 Email Library requires version 3.5 of the .NET Framework. This should already be present on almost all Windows computers, but can be obtained if necessary from the following address:

http://www.microsoft.com/en-us/download/details.aspx?id=22

1.3Licence

Unless otherwise specified in writing by FX Blue, this software is licensed for personal use only. You are not allowed to distribute it to other people, regardless of whether or not money is changing hands. You only have a licence to use the software if you, personally, downloaded it from our website.

The software is provided entirely at the user's risk, and you should check it thoroughly before deploying it on computers trading real money. FX Blue accepts no responsibility whatsoever for any loss of any kind caused by installation or use of the software.

2Using the MT4 Email Library

N.B. Any MQ4 code which uses the MT4 Email Library needs to be able to call DLL files. The "Allow DLL imports" setting must be turned on, either in the properties for the individual EA/script or at global level in MT4's Tools/Options/Expert Advisors settings. Please note that the global setting does not affect any EAs which are already running; it is the default which is used when you next add an EA or script to a chart.

An example of using MT4 Email Library can be found in the file "Example MQL for MT4 Email Library.mq4".

2.1Importing MT4EmailBridge.dll

The first step in using the library from MQ4 code is to import the DLL using a declaration such as the following:

#import "MT4EmailBridge.dll"
  int SendEmailW(string SMTPServer, int SMTPPort, string SMTPUsername, string SMTPPassword, 
                 int RequiresSSL, string EmailFromAddress, string EmailFromName, string EmailToAddress, 
                 string EmailToName, string CCRecipient, string BCCRecipient, string Subject, 
                 string Body, int IsHtmlEmail, string AttachedFiles, int Flags);
#import

2.2Calling the SendEmailW() function

The library provides one single function: SendEmailW(). The parameters for this function are as follows:

The SendEmailW() function should return more or less immediately. As with MT4's own built-in SendMail() function, message transmission is asynchronous and MQL4 code cannot tell whether a message has been successfully delivered.

2.3Message logging and return values from the SendEmailW() function

Message transmission from the library is asynchronous. Success or failure of messages is recorded in a separate log file, not in the MT4 journal. You can turn off logging of successful messages using the Flags parameter for SendEmailW().

The return value from SendEmailW() indicates whether the message was successfully queued for delivery. Because transmission is asynchronous, it does not indicate whether the message has successfully reached its recipient(s).

Possible values are as follows:

2.3.1Log file

All messages which are successfully queued for delivery (i.e. return value of 100 from SendEmailW) are logged in daily files in the following directory:

C:\Users\<your username>\AppData\Local\MT4-Email