EmailConfig.au3 UDF - support topic

[mLipok]

This UDF was created to facilitate the saving and reading of email configuration.
Thanks to @water, @jchd, @Jos for helping in translation of _EmailConfig_GUI_Preset_**()
Hope to have _EmailConfig_GUI_Preset_ES() version soon.

If you want to create your national version of _EmailConfig_GUI_Preset_**() please do not hesitate ... contribute.

_EmailConfig_GUI_Preset_EN() is translated by me and Google Translator (from my national Polish language), so if you have any fix for this please do not hesitate ... contribute.

 

The EmailConfig_Example_STMP_Mailer.au3   is using modified version of Jos SMTP Mailer UDF

 

expandcollapse popup

#AutoIt3Wrapper_UseX64=N
#AutoIt3Wrapper_Run_AU3Check=Y
#AutoIt3Wrapper_Au3Check_Parameters=-d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6 -w 7
#Tidy_Parameters=/sort_funcs /reel

#include <Array.au3>
#include <AutoItConstants.au3>
#include <ButtonConstants.au3>
#include <ComboConstants.au3>
#include <Crypt.au3>
#include <EditConstants.au3>
#include <File.au3>
#include <GUIConstantsEx.au3>
#include <StaticConstants.au3>
#include <WindowsConstants.au3>

#include "EmailConfig.au3"
#include "GDPR.au3" ; https://www.autoitscript.com/forum/files/file/509-gdpr/

Global $oMyRet[2]

#Region - EXAMPLE
_MY_EXAMPLE__EmailConfig()

Func _MY_EXAMPLE__EmailConfig()
    _GDPR_Crypter_Wrapper(_EmailConfig_ExampleCrypter)

    _EmailConfig_GUI_Preset_EN()
;~  _EmailConfig_GUI_Preset_DE()
;~  _EmailConfig_GUI_Preset_FR()
;~  _EmailConfig_GUI_Preset_NL()
;~  _EmailConfig_GUI_Preset_PL()

    _EmailConfig_SaveWrapper(_EmailConfig_SaveToINI)
    _EmailConfig_LoadWrapper(_EmailConfig_LoadFromINI)
    _EmailConfig_LoadWrapper()

    If $IDYES = MsgBox($MB_YESNO + $MB_TOPMOST + $MB_ICONQUESTION + $MB_DEFBUTTON1, 'Question #' & @ScriptLineNumber, _
            'Do you want to set email configuration ?') Then
        _EmailConfig_ShowGUI()
    EndIf

    Local $s_ToAddress = 'whereisyourdestination@your.email.com'
    Local $s_Subject = 'Testing email sending : ' & @YEAR & @MON & @MDAY & ' ' & @HOUR & @MIN & @SEC
    Local $s_Body = 'This is only a test'
    Local $s_Attachments = ''
    _SMTP_SendEmail_Example($s_ToAddress, $s_Subject, $s_Body, $s_Attachments)
EndFunc   ;==>_MY_EXAMPLE__EmailConfig

Func _EmailConfig_ExampleCrypter($dBinaryData, $bDataAlreadyEncrypted)
    _Crypt_Startup()     ; Start the Crypt library.
    Local $dResult
    If $bDataAlreadyEncrypted Then
        $dResult = _Crypt_DecryptData($dBinaryData, 'securepassword', $CALG_AES_256) ; Decrypt the data using the generic password string. The return value is a binary string.
    Else
        $dResult = _Crypt_EncryptData($dBinaryData, 'securepassword', $CALG_AES_256) ; Encrypt the text with the new cryptographic key.
    EndIf
    _Crypt_Shutdown()     ; Shutdown the Crypt library.
    Return $dResult
EndFunc   ;==>_EmailConfig_ExampleCrypter

#EndRegion - EXAMPLE

;
; The UDF
Func _INetSmtpMailCom($s_SmtpServer, $s_FromName, $s_FromAddress, $s_ToAddress, $s_Subject = "", $as_Body = "", $s_AttachFiles = "", $s_CcAddress = "", $s_BccAddress = "", $s_Importance = "Normal", $s_Username = "", $s_Password = "", $IPPort = 25, $ssl = 0, $tls = 0)
    Local $oCOM_Error_Handler = ObjEvent("AutoIt.Error", "MyErrFunc")
    #forceref $oCOM_Error_Handler

    Local $objEmail = ObjCreate("CDO.Message")
    $objEmail.From = '"' & $s_FromName & '" <' & $s_FromAddress & '>'
    $objEmail.To = $s_ToAddress
    Local $i_Error = 0
    #forceref $i_Error
    Local $i_Error_desciption = ""
    #forceref $i_Error_desciption
    If $s_CcAddress <> "" Then $objEmail.Cc = $s_CcAddress
    If $s_BccAddress <> "" Then $objEmail.Bcc = $s_BccAddress
    $objEmail.Subject = $s_Subject
    If StringInStr($as_Body, "<") And StringInStr($as_Body, ">") Then
        $objEmail.HTMLBody = $as_Body
    Else
        $objEmail.Textbody = $as_Body & @CRLF
    EndIf
    If $s_AttachFiles <> "" Then
        Local $S_Files2Attach = StringSplit($s_AttachFiles, ";")
        For $x = 1 To $S_Files2Attach[0]
            $S_Files2Attach[$x] = _PathFull($S_Files2Attach[$x])
;~          ConsoleWrite('@@ Debug : $S_Files2Attach[$x] = ' & $S_Files2Attach[$x] & @LF & '>Error code: ' & @error & @LF) ;### Debug Console
            If FileExists($S_Files2Attach[$x]) Then
                ConsoleWrite('+> File attachment added: ' & $S_Files2Attach[$x] & @LF)
                $objEmail.AddAttachment($S_Files2Attach[$x])
            Else
                ConsoleWrite('!> File not found to attach: ' & $S_Files2Attach[$x] & @LF)
                SetError(1)
                Return 0
            EndIf
        Next
    EndIf
    $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/sendusing") = 2
    $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/smtpserver") = $s_SmtpServer
    If Number($IPPort) = 0 Then $IPPort = 25
    $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/smtpserverport") = $IPPort
    ; Authenticated SMTP
    If $s_Username <> "" Then
        $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/smtpauthenticate") = 1
        $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/sendusername") = $s_Username
        $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/sendpassword") = $s_Password
    EndIf
    ; Set security params
    If $ssl Then $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/smtpusessl") = True
    If $tls Then $objEmail.Configuration.Fields.Item("http://schemas.microsoft.com/cdo/configuration/sendtls") = True
    ; Update settings
    $objEmail.Configuration.Fields.Update
    ; Set Email Importance
    Switch $s_Importance
        Case "High"
            $objEmail.Fields.Item("urn:schemas:mailheader:Importance") = "High"
        Case "Normal"
            $objEmail.Fields.Item("urn:schemas:mailheader:Importance") = "Normal"
        Case "Low"
            $objEmail.Fields.Item("urn:schemas:mailheader:Importance") = "Low"
    EndSwitch
    $objEmail.Fields.Update
    ; Sent the Message
    $objEmail.Send
    If @error Then
        SetError(2)
        Return $oMyRet[1]
    EndIf
    $objEmail = ""
EndFunc   ;==>_INetSmtpMailCom

Func _SMTP_SendEmail_Example($s_ToAddress, $s_Subject, $s_Body, $s_Attachments)
    #Tidy_ILC_Pos=120
    Local $aEMAIL_CONFIG = __EmailConfig__API()
    Local $SmtpServer = $aEMAIL_CONFIG[$EMAIL_CONFIG__22__SMTP_SERVER_NAME][$EMAIL_CONFIG__COL3_SAVELOAD_VALUE]        ; address for the smtp-server to use - REQUIRED
    Local $FromName = $aEMAIL_CONFIG[$EMAIL_CONFIG__02__COMMON_NAME][$EMAIL_CONFIG__COL3_SAVELOAD_VALUE]               ; name from who the email was sent
    Local $FromAddress = $aEMAIL_CONFIG[$EMAIL_CONFIG__03__EMAIL_ADDRESS][$EMAIL_CONFIG__COL3_SAVELOAD_VALUE]          ; address from where the mail should come
    Local $ToAddress = $s_ToAddress                                                                                    ; destination address of the email - REQUIRED
    Local $Subject = $s_Subject                                                                                        ; subject from the email - can be anything you want it to be
    Local $Body = $s_Body                                                                                              ; the messagebody from the mail - can be left blank but then you get a blank mail
    Local $AttachFiles = $s_Attachments                                                                                ; the file(s) you want to attach seperated with a ; (Semicolon) - leave blank if not needed
    Local $CcAddress = ""                                                                                              ; address for cc - leave blank if not needed
    Local $BccAddress = ""                                                                                             ; address for bcc - leave blank if not needed
    Local $Importance = "Normal"                                                                                       ; Send message priority: "High", "Normal", "Low"
    Local $Username = $aEMAIL_CONFIG[$EMAIL_CONFIG__20__SMTP_USER_NAME][$EMAIL_CONFIG__COL3_SAVELOAD_VALUE]            ; username for the account used from where the mail gets sent - REQUIRED
    Local $Password = $aEMAIL_CONFIG[$EMAIL_CONFIG__21__SMTP_PASSWORD][$EMAIL_CONFIG__COL3_SAVELOAD_VALUE]             ; password for the account used from where the mail gets sent - REQUIRED
    Local $IPPort = $aEMAIL_CONFIG[$EMAIL_CONFIG__23__SMTP_PORT_NUMBER][$EMAIL_CONFIG__COL3_SAVELOAD_VALUE]            ; port used for sending the mail ; in many country port 25 is not recomended, in such case use 587 instead
    Local $ssl = 0                                                                                                     ; enables/disables secure socket layer sending - put to 1 if using httpS
    Local $tls = 0                                                                                                     ; enables/disables TLS when required
;~  Local $IPPort = 465                                                                                                ; GMAIL port used for sending the mail
;~  Local $ssl = 1                                                                                                     ; GMAIL enables/disables secure socket layer sending - put to 1 if using httpS
    Local $rc = _INetSmtpMailCom($SmtpServer, $FromName, $FromAddress, $ToAddress, $Subject, $Body, $AttachFiles, $CcAddress, $BccAddress, $Importance, $Username, $Password, $IPPort, $ssl, $tls)
    If @error Then
        MsgBox(0, "Error sending email", "Error code: " & @error & @CRLF & "Description: " & $rc)
    EndIf
EndFunc   ;==>_SMTP_SendEmail_Example
;
;
; Com Error Handler
Func MyErrFunc(ByRef $oMyError)
    Local $HexNumber = Hex($oMyError.number, 8)
    $oMyRet[0] = $HexNumber
    $oMyRet[1] = StringStripWS($oMyError.description, 3)
    ConsoleWrite("### COM Error !  Number: " & $HexNumber & "   ScriptLine: " & $oMyError.scriptline & "   Description:" & $oMyRet[1] & @LF)
    SetError(1)                                                                                                        ; something to check for when this function returns
    Return
EndFunc   ;==>MyErrFunc

 

 

EmailConfig.au3Fetching info... EmailConfig_Example_STMP_Mailer.au3Fetching info...

Edited October 1, 2020 by mLipok