SetEmail

The SetEmailFieldFrom, SetEmailFieldTo, SetEmailFieldCC, SetEmailFieldBCC, SetEmailSubject, SetEmailMessage and SetEmailPrompt functions are used to set the various e-mail parameters that can be found in the Destination property tab of the Amyuni Converter products.

 

Syntax

ActiveX:

System.String EmailFieldFrom
System.String EmailFieldTo
System.String EmailFieldCC
System.String EmailFieldBCC
System.String EmailSubject
System.String EmailMessage

DLL:

int SetEmailFieldFrom(HANDLE hPrinter, LPCSTR szEmailFieldFrom)
int SetEmailFieldTo(HANDLE hPrinter, LPCSTR szEmailFieldTo)
int SetEmailFieldCC(HANDLE hPrinter, LPCSTR szEmailFieldCC)
int SetEmailFieldBCC(HANDLE hPrinter, LPCSTR szEmailFieldBCC)
int SetEmailSubject(HANDLE hPrinter, LPCSTR szEmailSubject)
int SetEmailMessage(HANDLE hPrinter, LPCSTR szEmailMessage;

 

Parameters

EmailFieldFrom, szEmailFieldFrom

Name of the email sender as it shows to the person receiving the e-mail. This parameter is used only in the case of sending e-mails through SMTP.

EmailFieldTo, szEmailFieldTo

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

EmailFieldCC, szEmailFieldCC

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

EmailFieldBCC, szEmailFieldBCC

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

EmailSubject, szEmailSubject

Subject of the email.  Some servers require to use UTF8: as prefix to support Unicode text.

EmailMessage, szEmailMessage

Email message.

hPrinter

Handle to printer returned by any of the DriverInit function calls.

 

Return Value

These functions return 1 if successful, 0 otherwise.

 

Remarks

E-mails can only be sent using SMTP protocol.  Please, check SMTP Settings.

 

Some SMTP servers don't allow direct Unicode for the text of the SMTP header, only UTF8 encoding.   In those cases, the UTF8:  prefix must be used for the subject field.  Ex: UTF8: Test subject ä ö ü Ä Ö Ü ß.  However, the conversion only will applied if there is any Unicode symbol.

 

Member of CDIntfEx.CDIntfEx.

 

Example

<Flags()>

Public Enum acFileNameOptions As Integer

    ' Please check FileNameOptions for the complete flags version

    NoPrompt = &H1

    UseFileName = &H2

    EmbedFonts = &H10

    BroadcastMessages = &H20

    SendByEmail = &H800

End Enum

 

Private Sub Sample()

    ' Constants for Activation codes

    Const strLicenseTo As String = "DOCX Converter Developer Evaluation"

    Const strActivationCode As String = "07EFCDAB010001002EE718DAABD90353AA8141F60B6762C695F4D5BA97F516CBE3EB407DC717EC1D28DE39A61F1ACE26924C99AFB190"

    Const AMYUNIPRINTERNAME As String = "Amyuni DOCX Converter"

 

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

    Dim DOCX 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

    DOCX.DriverInit(AMYUNIPRINTERNAME)

 

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

    ' initialized by the DriverInit functions.

    DOCX.SetDefaultPrinter()

 

    ' Resulting DOCX document stored here

    DOCX.DefaultDirectory = "C:\Temp"

 

    ' Set Printer options

    DOCX.FileNameOptionsEx = acFileNameOptions.NoPrompt Or acFileNameOptions.SendByEmail

 

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

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

    DOCX.EnablePrinter(strLicenseTo, strActivationCode)

 

    ' Set email parameters

    DOCX.EmailFieldTo = "info@amyuni.com"

    DOCX.EmailFieldFrom = "support@amyuni.com"

    DOCX.EmailSubject = "Testing email capabilities"

    DOCX.EmailMessage = "Please find attached the requested document\nin RTF format."

 

    ' Set SMTP paramters

    DOCX.SmtpServer = "smtp.amyuni.com"

    DOCX.SmtpPort = 25

    DOCX.SmtpUsername = "amyuni"

    DOCX.SmtpPassword = "123456"

 

    ' The BatchConvert method converts a number of files to DOCX.

    DOCX.BatchConvert("C:\Temp\*.ppt")

 

    ' The RestoreDefaultPrinter function resets the system default printer 

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

    DOCX.RestoreDefaultPrinter()

 

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

    DOCX.DriverEnd()

 

    ' Destroy DOCX object

    DOCX = Nothing    

End Sub

[Flags]

public enum acFileNameOptions

{

    // Please check FileNameOptions for the complete flags version

    NoPrompt = 0x00000001,

    UseFileName = 0x00000002,

    EmbedFonts = 0x00000010,

    BroadcastMessages = 0x00000020,

    SendByEmail = 0x00000800

}

 

private void Sample()

{

    // Constants for Activation codes

    const string strLicenseTo = "DOCX Converter Developer Evaluation";

    const string strActivationCode = "07EFCDAB010001002EE718DAABD90353AA8141F60B6762C695F4D5BA97F516CBE3EB407DC717EC1D28DE39A61F1ACE26924C99AFB190";

    const string AMYUNIPRINTERNAME = "Amyuni DOCX Converter";

 

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

    CDIntfEx.CDIntfEx DOCX = 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

    DOCX.DriverInit(AMYUNIPRINTERNAME);

 

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

    // initialized by the DriverInit functions.

    DOCX.SetDefaultPrinter();

 

    // Resulting DOCX document stored here

    DOCX.DefaultDirectory = "C:\\Temp";

 

    // Set Printer options

    DOCX.FileNameOptionsEx =(int)(acFileNameOptions.NoPrompt | acFileNameOptions.SendByEmail);

 

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

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

    DOCX.EnablePrinter(strLicenseTo, strActivationCode);

 

    // Set email parameters

    DOCX.EmailFieldTo = "info@amyuni.com";

    DOCX.EmailFieldFrom = "support@amyuni.com";

    DOCX.EmailSubject = "Testing email capabilities";

    DOCX.EmailMessage = "Please find attached the requested document\nin RTF format.";

 

    // Set SMTP paramters

    DOCX.SmtpServer = "smtp.amyuni.com";

    DOCX.SmtpPort = 25;

    DOCX.SmtpUsername = "amyuni";

    DOCX.SmtpPassword = "123456";

 

    // The BatchConvert method converts a number of files to DOCX.

    DOCX.BatchConvert("C:/Temp/*.ppt");

 

    // The RestoreDefaultPrinter function resets the system default printer 

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

    DOCX.RestoreDefaultPrinter();

 

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

    DOCX.DriverEnd();

 

    // Destroy DOCX object

    DOCX = null;    

}

// DOCX 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  "DOCX Converter Developer Evaluation"

    #define strActivationCode "07EFCDAB010001002EE718DAABD90353AA8141F60B6762C695F4D5BA97F516CBE3EB407DC717EC1D28DE39A61F1ACE26924C99AFB190"

    #define AMYUNIPRINTERNAME "Amyuni DOCX 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 DOCX = DriverInit(AMYUNIPRINTERNAME);

 

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

    // initialized by the DriverInit functions.

    CDISetDefaultPrinter(DOCX);

 

    // Resulting DOCX document stored here

    SetDefaultDirectory(DOCX, "C:/Temp");

 

    // Set Printer options

    SetFileNameOptions(DOCX, NoPrompt | SendByEmail);

 

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

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

    EnablePrinter(DOCX, strLicenseTo, strActivationCode);

 

    // Set email parameters

    SetEmailFieldTo(DOCX, "info@amyuni.com");

    SetEmailFieldFrom(DOCX, "support@amyuni.com");

    SetEmailSubject(DOCX, "Testing email capabilities");

    SetEmailMessage(DOCX, "Please find attached the requested document\nin RTF format.");

 

    // Set SMTP paramters

    SetSmtpServer(DOCX, "smtp.amyuni.com");

    SetSmtpPort(DOCX, 25);

    SetSmtpUsername(DOCX, "amyuni");

    SetSmtpPassword(DOCX, "123456");

 

    // The BatchConvert method converts a number of files to DOCX.

    BatchConvertEx(DOCX, "C:/Temp/*.ppt");

 

    // The RestoreDefaultPrinter function resets the system default printer 

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

    RestoreDefaultPrinter(DOCX);

 

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

    DriverEnd(DOCX);    

 

    // Destroy DOCX object

    DOCX = NULL;    

 

    return 0;

}

package Example;

 

import com.jacob.activeX.ActiveXComponent;

import com.jacob.com.Dispatch;

 

public class Sample {

    public enum acFileNameOptions

    {

        // Please check FileNameOptions for the complete flags version

        NoPrompt(0x00000001),

        UseFileName(0x00000002),

        EmbedFonts(0x00000010),

        BroadcastMessages(0x00000020);

        SendByEmail(0x00000800);

        private int value;

        private acFileNameOptions(int value)

        {

            this.value = value;

        }

        public Object value(){

            return value;

        }

    }

 

    public static void main(String[] args)

    {

        // Constants for Activation codes

        String strLicenseTo  = "DOCX Converter Developer Evaluation";

        String strActivationCode = "07EFCDAB010001002EE718DAABD90353AA8141F60B6762C695F4D5BA97F516CBE3EB407DC717EC1D28DE39A61F1ACE26924C99AFB190";

        String AMYUNIPRINTERNAME = "Amyuni DOCX Converter";

 

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

        ActiveXComponent docx = 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(docx,"DriverInit",AMYUNIPRINTERNAME);

 

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

        // initialized by the DriverInit functions.

        Dispatch.call(docx,"SetDefaultPrinter");

 

        // Resulting DOCX document stored here

        Dispatch.put(docx,"DefaultDirectory","c:\\Temp");

 

        // Set Printer options

        Dispatch.put(docx,"FileNameOptionsEx",acFileNameOptions.NoPrompt.value | acFileNameOptions.SendByEmail.value);

 

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

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

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

 

        // Set email parameters

        Dispatch.put(docx,"EmailFieldTo", "info@amyuni.com");

        Dispatch.put(docx,"EmailFieldFrom", "support@amyuni.com");

        Dispatch.put(docx,"EmailSubject", "Testing email capabilities");

        Dispatch.put(docx,"EmailMessage", "Please find attached the requested document\nin RTF format.");

 

        // Set SMTP paramters

        Dispatch.put(docx,"SmtpServer", "smtp.amyuni.com");

        Dispatch.put(docx,"SmtpPort", 25);

        Dispatch.put(docx,"SmtpUsername", "amyuni");

        Dispatch.put(docx,"SmtpPassword", "123456");

 

        // The BatchConvert method converts a number of files to DOCX.

        Dispatch.call(docx,"BatchConvert","c:\\Temp\\*.ppt");

 

        // The RestoreDefaultPrinter function resets the system default printer 

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

        Dispatch.call(docx,"RestoreDefaultPrinter"); 

 

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

        Dispatch.call(docx,"DriverEnd");

 

        // Destroy DOCX object

        docx = null;        

    }

}

#Please check FileNameOptions for the complete flags version

$acFileNameOptions = @{

    NoPrompt = 0x00000001

    UseFileName = 0x00000002

    EmbedFonts = 0x00000010

    BroadcastMessages = 0x00000020

    SendByEmail = 0x00000800

 

# Constants for Activation codes

$strLicenseTo  =  "DOCX Converter Developer Evaluation"

$strActivationCode = "07EFCDAB010001002EE718DAABD90353AA8141F60B6762C695F4D5BA97F516CBE3EB407DC717EC1D28DE39A61F1ACE26924C99AFB190"

$AMYUNIPRINTERNAME = "Amyuni DOCX Converter"

 

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

$DOCX = 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,$DOCX,$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,$DOCX,$null)

 

#Resulting DOCX document stored here

[System.__ComObject].InvokeMember('DefaultDirectory', [System.Reflection.BindingFlags]::SetProperty,$null,$DOCX,"C:/Temp")

 

#Set Printer options

[System.__ComObject].InvokeMember('FileNameOptionsEx', [System.Reflection.BindingFlags]::SetProperty,$null,$DOCX, 

        $acFileNameOptions::NoPrompt -bOr $acFileNameOptions::SendByEmail)

 

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

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

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

 

#Set email parameters

[System.__ComObject].InvokeMember('EmailFieldTo', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "info@amyuni.com")

[System.__ComObject].InvokeMember('EmailFieldFrom', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "support@amyuni.com")

[System.__ComObject].InvokeMember('EmailSubject', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "Testing email capabilities")

[System.__ComObject].InvokeMember('EmailMessage', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "Please find attached the requested document\nin RTF format.")

 

#Set SMTP paramters

[System.__ComObject].InvokeMember('SmtpServer', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "smtp.amyuni.com")

[System.__ComObject].InvokeMember('SmtpPort', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, 25)

[System.__ComObject].InvokeMember('SmtpUsername', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "amyuni")

[System.__ComObject].InvokeMember('SmtpPassword', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "123456")

 

#The BatchConvert method converts a number of files to DOCX.

[System.__ComObject].InvokeMember('BatchConvert', [System.Reflection.BindingFlags]::InvokeMethod,$null,$DOCX, "C:\Temp\*.ppt")

 

#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,$DOCX,$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,$DOCX,$null)

 

#Destroy DOCX object

$DOCX = $null

' FileNameOptions constants

' Please check FileNameOptions for the complete flags version

Const NoPrompt = &H1

Const UseFileName = &H2

Const EmbedFonts = &H10

Const BroadcastMessages = &H20

 

' Constants for Activation codes

Const strLicenseTo = "DOCX Converter Developer Evaluation"

Const strActivationCode = "07EFCDAB010001002EE718DAABD90353AA8141F60B6762C695F4D5BA97F516CBE3EB407DC717EC1D28DE39A61F1ACE26924C99AFB190"

Const AMYUNIPRINTERNAME = "Amyuni DOCX Converter"

 

' Declare a new cdintfex object

Dim DOCX

Set DOCX = 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

DOCX.DriverInit AMYUNIPRINTERNAME

 

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

' initialized by the DriverInit functions.

DOCX.SetDefaultPrinter

 

' Resulting DOCX document stored here

DOCX.DefaultDirectory = "C:\Temp"

 

' Set Printer options

DOCX.FileNameOptionsEx = NoPrompt Or SendByEmail

 

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

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

DOCX.EnablePrinter strLicenseTo, strActivationCode

 

' Set email parameters

DOCX.EmailFieldTo = "info@amyuni.com"

DOCX.EmailFieldFrom = "support@amyuni.com"

DOCX.EmailSubject = "Testing email capabilities"

DOCX.EmailMessage = "Please find attached the requested document\nin DOCX format."

 

' Set SMTP paramters

DOCX.SmtpServer = "smtp.amyuni.com"

DOCX.SmtpPort = 25

DOCX.SmtpUsername = "amyuni"

DOCX.SmtpPassword = "123456"

 

' The BatchConvert method converts a number of files to DOCX.

DOCX.BatchConvert "C:\Temp\*.ppt"

 

' The RestoreDefaultPrinter function resets the system default printer

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

DOCX.RestoreDefaultPrinter

 

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

DOCX.DriverEnd

 

' Destroy docx object

Set DOCX = Nothing