SendMail (with Attachments using MAPI)

The SendMail function is used to send a message with one or more attachments using MAPI e-mail.

 

Syntax

ActiveX:

System.Int32 SendMail(System.String szTo, System.String szCC, System.String szBCC, System.String szSubject, System.String szMessage, System.String szFilenames, System.Int32 lOptions)

DLL:

long SendMail(LPCSTR szTo, LPCSTR szCC, LPCSTR szBCC, LPCSTR szSubject, LPCSTR szMessage, LPCSTR szFilenames, long lOptions)
long SendMailW(LPCWSTR szTo, LPCWSTR szCC, LPCWSTR szBCC, LPCWSTR szSubject, LPCWSTR szMessage, LPCWSTR szFilenames, long lOptions)

 

Parameters

szTo

Name and e-mail address of the e-mail destination. Multiple addresses can be specified by separating them with semi-colons (;).

szCC

Name and e-mail address of the e-mail Carbon Copy list. Multiple addresses can be specified by separating them with semi-colons (;).

szBCC

Handle Name and e-mail address of the e-mail Blind Carbon Copy list. Multiple addresses can be specified by separating them with semi-colons (;).

szSubject

Subject of the e-mail.

szMessage

E-mail message.

szFileNames

Series of file names and their captions as they should appear in the e-mail attachment. The file name is the full path of the file to send, the caption is the name of the file as seen by the recipient. The syntax for sending multiple files is as follows: file1;caption1;file2;caption2; etc.

lOptions

Options specific to sending e-mails. The list of supported options is in the Remarks section below.

 

nEmailOptions values

Value

Prompt before sending e-mail.

2

 

 

Return Value

The SendMail function returns the value MAPI_E_NOT_SUPPORTED if no MAPI compliant e-mail is installed in the system. It returns 0 if successful or a MAPI specific error code if an error occurs when sending the e-mail.

 

Remarks

It  should be an Ansi string for SendMail or a Unicode string for SendMailW.

 

Depending on the security settings of the system from which the e-mail is sent, the users might be prompted with a confirmation message stating that an external application is trying to send an e-mail on their behalf. This is an important MAPI security measure which cannot and should not be overridden.

 

Member of CDIntfEx.CDIntfEx.

 

Example

 Private Sub Sample()


    ' Constants for Activation codes


    Const strLicenseTo As String = "Amyuni PDF Converter Evaluation"


    Const strActivationCode As String = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


    Const AMYUNIPRINTERNAME As String = "Amyuni PDF Converter"


 


    ' Declare a new cdintfex object if it does not exist in the form.


    Dim PDF As New CDIntfEx.CDIntfEx


 


    ' Get a reference to the installed printer.


    ' This will fail if the printer name passed to the DriverInit method is 


    ' not found in the printer’s folder


    PDF.DriverInit(AMYUNIPRINTERNAME)


 


    ' The SetDefaultPrinter function sets the system default printer to the one


    ' initialized by the DriverInit functions.


    PDF.SetDefaultPrinter()


 


    ' The EnablePrinter() method needs to be called right before each print job.


    ' and before the configuration


    ' Calling the EnablePrinter() method will start a 20 second time-out value


    PDF.EnablePrinter(strLicenseTo, strActivationCode)


 


    ' Set SendMail


    PDF.SendMail("info@amyuni.com", "sales@amyuni.com", "", "Testing email capabilities",


                        "Please find attached the requested document\nin RTF format.",


                        "c:\\temp1.pdf;document1.pdf;c:\\temp2.pdf;document2.pdf",


                         2)


 


    ' The RestoreDefaultPrinter function resets the system default printer 


    ' to the printer that was the default before the call to SetDefaultPrinter.


    PDF.RestoreDefaultPrinter()


 


    ' This function will simply detach from an existing printer because the handle was created using DriverInit


    PDF.DriverEnd()


End Sub


private void Sample()


{


    // Constants for Activation codes


    const string strLicenseTo = "Amyuni PDF Converter Evaluation";


    const string strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA";


    const string AMYUNIPRINTERNAME = "Amyuni PDF Converter";


 


    // Declare a new cdintfex object if it does not exist in the form.


    CDIntfEx.CDIntfEx PDF = new CDIntfEx.CDIntfEx();


 


    // Get a reference to the installed printer.


    // This will fail if the printer name passed to the DriverInit method is 


    // not found in the printer’s folder


    PDF.DriverInit(AMYUNIPRINTERNAME);


 


    // The SetDefaultPrinter function sets the system default printer to the one


    // initialized by the DriverInit functions.


    PDF.SetDefaultPrinter();


 


    // The EnablePrinter() method needs to be called right before each print job.


    // and before the configuration


    // Calling the EnablePrinter() method will start a 20 second time-out value


    PDF.EnablePrinter(strLicenseTo, strActivationCode);


 


    // Set SendMail


    PDF.SendMail("info@amyuni.com", "sales@amyuni.com", "", "Testing email capabilities",


                "Please find attached the requested document\nin RTF format.",


                "c:\\temp1.pdf;document1.pdf;c:\\temp2.pdf;document2.pdf",


                 2);


 


    // The RestoreDefaultPrinter function resets the system default printer


    // to the printer that was the default before the call to SetDefaultPrinter.


    PDF.RestoreDefaultPrinter();


 


    // This function will simply detach from an existing printer because the handle was created using DriverInit


    PDF.DriverEnd();


 


 


}


// PDF Converter Cpp.cpp : Defines the entry point for the console application.


// 


 


#include <Windows.h>


#include <string>


#include <iostream>


#include "CdIntf.h"


#pragma comment (lib, "CDIntf.lib")


 


using namespace std;


 


 


int main()


{


     // Constants for Activation codes


    #define strLicenseTo  "Amyuni PDF Converter Evaluation"


    #define strActivationCode "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


    #define AMYUNIPRINTERNAME "Amyuni PDF Converter"


 


    // Get a reference to the installed printer.


    // This will fail if the printer name passed to the DriverInit method is 


    // not found in the printer’s folder


    HANDLE PDF = DriverInit(AMYUNIPRINTERNAME);


 


    // The CDISetDefaultPrinter function sets the system default printer to the one


    // initialized by the DriverInit functions.


    CDISetDefaultPrinter(PDF);


 


    // The EnablePrinter() method needs to be called right before each print job.


    // and before the configuration


    // Calling the EnablePrinter() method will start a 20 second time-out value


    EnablePrinter(PDF, strLicenseTo, strActivationCode);


 


    // Set SendMail


    SendMail("info@amyuni.com", "sales@amyuni.com", "", "Testing email capabilities",


                "Please find attached the requested document\nin RTF format.",


                "c:\\temp1.pdf;document1.pdf;c:\\temp2.pdf;document2.pdf",


                 2);


 


    // The RestoreDefaultPrinter function resets the system default printer 


    // to the printer that was the default before the call to SetDefaultPrinter.


    RestoreDefaultPrinter(PDF);


 


    // This function will simply detach from an existing printer because the handle was created using DriverInit


    DriverEnd(PDF);    


 


    // Destroy PDF object


    PDF = nullptr;  


 


    return 0;


}


package Example;


 


import com.jacob.activeX.ActiveXComponent;


import com.jacob.com.Dispatch;


 


public class Sample {


    public static void main(String[] args)


    {


        // Constants for Activation codes


        String strLicenseTo  = "Amyuni PDF Converter Evaluation";


        String strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA";


        String AMYUNIPRINTERNAME = "Amyuni PDF Converter";


 


        // Declare a new cdintfex object if it does not exist in the form.


        ActiveXComponent pdf = new ActiveXComponent("CDIntfEx.CDIntfEx.6.5"); 


 


        // Get a reference to the installed printer.


        // This will fail if the printer name passed to the DriverInit method is 


        // not found in the printer’s folder


        Dispatch.call(pdf,"DriverInit",AMYUNIPRINTERNAME);


 


        // The SetDefaultPrinter function sets the system default printer to the one


        // initialized by the DriverInit functions.


        Dispatch.call(pdf,"SetDefaultPrinter");


 


        // The EnablePrinter() method needs to be called right before each print job.


        // and before the configuration


        // Calling the EnablePrinter() method will start a 20 second time-out value


        Dispatch.call(pdf,"EnablePrinter", strLicenseTo, strActivationCode); 


 


        // Set SendMail


        Dispatch.call(pdf,"SendMail", "info@amyuni.com", "sales@amyuni.com", "", "Testing email capabilities",


                "Please find attached the requested document\nin RTF format.",


                "c:\\temp1.pdf;document1.pdf;c:\\temp2.pdf;document2.pdf",


                 2);


 


        // The RestoreDefaultPrinter function resets the system default printer 


        // to the printer that was the default before the call to SetDefaultPrinter.


        Dispatch.call(pdf,"RestoreDefaultPrinter"); 


 


        // This function will simply detach from an existing printer because the handle was created using DriverInit


        Dispatch.call(pdf,"DriverEnd");


 


        // Destroy PDF object


        pdf = null;        


    }


}


# Constants for Activation codes


$strLicenseTo  =  "Amyuni PDF Converter Evaluation"


$strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


$AMYUNIPRINTERNAME = "Amyuni PDF Converter"


 


#Declare a new cdintfex object if it does not exist in the form.


$PDF = New-Object -ComObject CDIntfEx.CDIntfEx.6.5


 


#Get a reference to the installed printer.


#This will fail if the printer name passed to the DriverInit method is 


#not found in the printer’s folder


[System.__ComObject].InvokeMember('DriverInit', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$AMYUNIPRINTERNAME) 


 


#The SetDefaultPrinter function sets the system default printer to the one


#initialized by the DriverInit functions.


[System.__ComObject].InvokeMember('SetDefaultPrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null) 


 


#The EnablePrinter() method needs to be called right before each print job.


#and before the configuration


#Calling the EnablePrinter() method will start a 20 second time-out value


[System.__ComObject].InvokeMember('EnablePrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, @($strLicenseTo, $strActivationCode))


 


#Set SendMail


[System.__ComObject].InvokeMember('SendMail', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, 


    @("info@amyuni.com", "sales@amyuni.com", "", "Testing email capabilities",


                        "Please find attached the requested document\nin RTF format.",


                        "c:\\temp1.pdf;document1.pdf;c:\\temp2.pdf;document2.pdf",


                         2))


 


#The RestoreDefaultPrinter function resets the system default printer 


#to the printer that was the default before the call to SetDefaultPrinter.


[System.__ComObject].InvokeMember('RestoreDefaultPrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null) 


 


#This function will simply detach from an existing printer because the handle was created using DriverInit 


[System.__ComObject].InvokeMember('DriverEnd', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null) 


 


#Destroy PDF object


$PDF = $null


' Constants for Activation codes


Const strLicenseTo = "Amyuni PDF Converter Evaluation"


Const strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


Const AMYUNIPRINTERNAME = "Amyuni PDF Converter"


 


' Declare a new cdintfex object


Dim PDF


Set PDF = CreateObject("CDIntfEx.CDIntfEx.6.5")


 


' Get a reference to the installed printer.


' This will fail if the printer name passed to the DriverInit method is


' not found in the printer’s folder


PDF.DriverInit AMYUNIPRINTERNAME


 


' The SetDefaultPrinter function sets the system default printer to the one


' initialized by the DriverInit functions.


PDF.SetDefaultPrinter


 


' The EnablePrinter() method needs to be called right before each print job.


' and before the configuration


' Calling the EnablePrinter() method will start a 20 second time-out value


PDF.EnablePrinter strLicenseTo, strActivationCode


 


' Set SendMail


 


PDF.SendMail "info@amyuni.com", "sales@amyuni.com", "", "Testing email capabilities",_


    "Please find attached the requested document\nin RTF format.",_


    "c:\\temp1.pdf;document1.pdf;c:\\temp2.pdf;document2.pdf", 2


 


' The RestoreDefaultPrinter function resets the system default printer


' to the printer that was the default before the call to SetDefaultPrinter.


PDF.RestoreDefaultPrinter


 


' This function will simply detach from an existing printer because the handle was created using DriverInit


PDF.DriverEnd


 


' Destroy pdf object


Set PDF = Nothing