The SetDefaultPrinter function sets the system default printer to the one initialized by the DriverInit functions.
This call is only a wrapper to the Windows function SetDefaultPrinter which is documented here: https://msdn.microsoft.com/en-us/library/windows/desktop/dd162971(v=vs.85).aspx
Calling this function prior to printing is not recommended especially on servers for the following reasons:
The user might not have the rights to change the default printer on the server.
The application might need to be restarted for it to detect the new default printer, this largely depends on how the application is written.
There might be a significant delay before the call takes effect depending on the number of running applications and server load.
System.Boolean SetDefaultPrinter()
long CDISetDefaultPrinter(HANDLE hPrinter)
hPrinter
Handle to printer returned by any of the DriverInit function calls.
If the system default printer was modified, this function returns 1. It returns 0 if the default printer was not modified. A return value of 0 usually indicates that the printer was already the system default printer before the call to SetDefaultPrinter.
Some applications require that the printer be set as default before being able to print to that printer. The default printer that was set before calling this function is restored in one of three situations:
The function RestoreDefaultPrinter is called.
DriverEnd is called.
The calling application is closed.
To make sure the previous default printer is not restored when calling DriverEnd or when the calling application is destroyed, you can call this function twice.
Modifying the system default printer too frequently is a source of numerous printing errors. Developers are encouraged to use methods supplied by their application to specify the destination printer rather than calling this function.
The user needs to have the rights to change the default printer.
Member of CDIntfEx.CDIntfEx.
<Flags()>
Public Enum acFileNameOptions As Integer
' Please check FileNameOptions for the complete flags version
NoPrompt = &H1
UseFileName = &H2
EmbedFonts = &H10
BroadcastMessages = &H20
End Enum
Public 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
' 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)
' 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,
}
public 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;
// 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);
// 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);
// 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);
// 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);
public int value;
public 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);
// 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);
// 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;
}
}
$acFileNameOptions = @{
NoPrompt = 0x00000001
UseFileName = 0x00000002
EmbedFonts = 0x00000010
BroadcastMessages = 0x00000020
}
#Please check FileNameOptions for the complete flags version
# 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)
#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))
#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
' 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
' 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