Encryption

The Encryption property password protects a PDF document and restricts users to viewing, modifying or even printing the document. This function requires a call to SetLicenseKey before it can be used.

 

Syntax

ActiveX:

System.Int32 Encryption

DLL:

long GetEncryption(HANDLE hIntf)
void SetEncryption(HANDLE hIntf, long nNewValue)

 

Parameters

hIntf

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

nNewValue

Encryption type.

Encryption Type

Value

No encryption

0

40 bits encryption

1

128 bits encryption

2

256 bits encryption

This requires a special license

3

 

Return Value

Encryption and GetEncryption return the current  encryption type.

 

Remarks

The permissions, owner password and user password are configured by using Permission, OwnerPassword and UserPassword properties.

 

In the case of the evaluation version, the passwords are always set to "aaaaaa" (OwnerPassword) and "bbbbbb" (UserPassword) and cannot be changed.

 

When the Encryption option needs to be changed for a specific printout and not set as default for all printouts, the FileNameOptionsEx property provides a more efficient way using EncryptDocument, EncryptDocument128 and EncryptDocument256 flags.

 

However, if the default setting in the  Encryption is enabled.  It is not possible to generate No Encrypted file programmatically just using FileNameOptionsEx property.

 

Member of CDIntfEx.CDIntfEx.

 

Example

Public Enum ENCRYPTION As Integer

    NO_ENCRYPTION = 0

    ENCRYPT_DOCUMENT = 1

    ENCRYPT_DOCUMENT128 = 2

    ENCRYPT_DOCUMENT256 = 3

End Enum

 

<Flags()>

Public Enum PERMISSIONS As Integer

    NO_PERMISSION = &HFFFFFFC0

    ENABLE_PRINTING = &H4

    ENABLE_DOCUMENT_MODIFICATION = &H8

    ENABLE_COPYING_TEXT_GRAPHICS = &H10

    ENABLE_ADDING_CHANGING_NOTES = &H20

End Enum

 

<Flags()>

Public Enum acFileNameOptions As Integer

    ' Please check FileNameOptions for the complete flags version

    NoPrompt = &H1

    UseFileName = &H2

    Concatenate = &H4

    DisableCompression = &H8

    EmbedFonts = &H10

    BroadcastMessages = &H20

    PrintWatermark = &H40

    EncryptDocument = &H100

    EncryptDocument128 = &H40000000

    EncryptDocument256 = &H40000100

End Enum

Public 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)

 

    ' Resulting PDF document stored here

    PDF.DefaultDirectory = "C:\Temp"

 

    ' Set Printer options

    PDF.FileNameOptionsEx = acFileNameOptions.NoPrompt

 

    ' Set Password to protect a PDF document and restricts users to viewing

    PDF.Encryption = ENCRYPTION.ENCRYPT_DOCUMENT

 

    ' Set OwnerPassword

    PDF.OwnerPassword = "owner123"

 

    ' Set UserPassword

    PDF.UserPassword = "user123"

 

    ' Set Permissions

    PDF.Permissions = PERMISSIONS.NO_PERMISSION Or PERMISSIONS.ENABLE_PRINTING

 

    ' Apply Settings

    PDF.SetDefaultConfig()

 

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

    PDF.BatchConvert("C:\Temp\*.docx")

 

    ' 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

public enum ENCRYPTION

{

    NO_ENCRYPTION = 0,

    ENCRYPT_DOCUMENT = 1,

    ENCRYPT_DOCUMENT128 = 2,

    ENCRYPT_DOCUMENT256 = 3

}

 

[Flags]

public enum PERMISSIONS

{

    NO_PERMISSION = unchecked((int)0xFFFFFFC0),

    ENABLE_PRINTING = 0x4,

    ENABLE_DOCUMENT_MODIFICATION = 0x8,

    ENABLE_COPYING_TEXT_GRAPHICS = 0x10,

    ENABLE_ADDING_CHANGING_NOTES = 0x20

}

 

[Flags]

public enum acFileNameOptions

{

    // Please check FileNameOptions for the complete flags version

    NoPrompt = 0x00000001,

    UseFileName = 0x00000002,

    Concatenate = 0x00000004,

    DisableCompression = 0x00000008,

    EmbedFonts = 0x00000010,

    BroadcastMessages = 0x00000020,

    PrintWatermark = 0x00000040,

    EncryptDocument = 0x00000100,

    EncryptDocument128 = 0x40000000,

    EncryptDocument128 = 0x40000100

}

 

public 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();

 

    // Resulting PDF document stored here

    PDF.DefaultDirectory = @"C:\Temp";

 

    // Set Printer options

    PDF.FileNameOptionsEx = (int)acFileNameOptions.NoPrompt;

 

    // 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 Password to protect a PDF document and restricts users to viewing

    PDF.Encryption = (int)ENCRYPTION.ENCRYPT_DOCUMENT;

 

    // Set OwnerPassword

    PDF.OwnerPassword = "owner123";

 

    // Set UserPassword

    PDF.UserPassword = "user123";

 

    // Set Permissions

    PDF.Permissions = (int)(PERMISSIONS.NO_PERMISSION | PERMISSIONS.ENABLE_PRINTING);

 

    // Apply Settings

    PDF.SetDefaultConfig();

 

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

    PDF.BatchConvert(@"C:\Temp\*.docx");

 

    // 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;

 

enum ENCRYPTION

{

    NO_ENCRYPTION = 0,

    ENCRYPT_DOCUMENT = 1,

    ENCRYPT_DOCUMENT128 = 2

    ENCRYPT_DOCUMENT256 = 3

};

 

enum PERMISSIONS 

{

    NO_PERMISSION = 0xFFFFFFC0,

    ENABLE_PRINTING = 0x4,

    ENABLE_DOCUMENT_MODIFICATION = 0x8,

    ENABLE_COPYING_TEXT_GRAPHICS = 0x10,

    ENABLE_ADDING_CHANGING_NOTES = 0x20

}; 

 

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);

 

    // Resulting PDF document stored here

    SetDefaultDirectory(PDF, "c:\\Temp");

 

    // Set Printer options

    SetFileNameOptions(PDF, NoPrompt);

 

    // Set Password to protect a PDF document and restricts users to viewing

    SetEncryption(PDF, ENCRYPTION::ENCRYPT_DOCUMENT);

 

    // Set OwnerPassword

    SetOwnerPassword(PDF, "owner123");

 

    // Set UserPassword

    SetUserPassword(PDF, "user123";

 

    // Set Permissions

    SetPermissions(PDF, PERMISSIONS::NO_PERMISSION | PERMISSIONS::ENABLE_PRINTING);

 

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

    BatchConvertEx(PDF, "c:\\Temp\\*.docx");

 

    // 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 enum ENCRYPTION

    {

        NO_ENCRYPTION(0),

        ENCRYPT_DOCUMENT(1),

        ENCRYPT_DOCUMENT128(2),

        ENCRYPT_DOCUMENT256(3);

        public int value;

        public ENCRYPTION(int value)

        {

            this.value = value;

        }

        public Object value(){

            return value;

        }        

    } 

 

    public enum PERMISSIONS 

    {

        NO_PERMISSION (0xFFFFFFC0),

        ENABLE_PRINTING (0x4),

        ENABLE_DOCUMENT_MODIFICATION (0x8),

        ENABLE_COPYING_TEXT_GRAPHICS (0x10),

        ENABLE_ADDING_CHANGING_NOTES (0x20);

        public int value;

        public PERMISSIONS(int value)

        {

            this.value = value;

        }

        public Object value(){

            return value;

        }

    }

 

    public enum acFileNameOptions

    {

        // Please check FileNameOptions for the complete flags version

        NoPrompt(0x00000001),

        UseFileName(0x00000002),

        Concatenate(0x00000004),

        DisableCompression(0x00000008),

        EmbedFonts(0x00000010),

        BroadcastMessages(0x00000020),

        PrintWatermark(0x00000040),

        EncryptDocument(0x00000100),

        EncryptDocument128(0x40000000),

        EncryptDocument256(0x40000100);

        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  = "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); 

 

        // Resulting PDF document stored here

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

 

        // Set Printer options

        Dispatch.put(pdf,"FileNameOptionsEx",acFileNameOptions.NoPrompt.value);

 

        // Set Password to protect a PDF document and restricts users to viewing

        Dispatch.put(pdf,"Encryption", ENCRYPTION.ENCRYPT_DOCUMENT.value);

 

        // Set OwnerPassword

        Dispatch.call(pdf,"OwnerPassword", "owner123");

 

        // Set UserPassword

        Dispatch.call(pdf,"UserPassword", "user123");

 

        // Set Permissions

        Dispatch.call(pdf,"Permissions", PERMISSIONS.NO_PERMISSION.value + PERMISSIONS.ENABLE_PRINTING.value);

 

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

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

 

        // 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;        

    }

}

Public Enum ENCRYPTION As Integer

    NO_ENCRYPTION = 0

    ENCRYPT_DOCUMENT = 1

    ENCRYPT_DOCUMENT128 = 2

    ENCRYPT_DOCUMENT256 = 3

End Enum

 

$PERMISSIONS = @{

    NO_PERMISSION = 0xFFFFFFC0

    ENABLE_PRINTING = 0x4

    ENABLE_DOCUMENT_MODIFICATION = 0x8

    ENABLE_COPYING_TEXT_GRAPHICS = 0x10

    ENABLE_ADDING_CHANGING_NOTES = 0x20

}

 

$acFileNameOptions = @{

    NoPrompt = 0x00000001

    UseFileName = 0x00000002

    Concatenate = 0x00000004

    DisableCompression = 0x00000008

    EmbedFonts = 0x00000010

    BroadcastMessages = 0x00000020

    PrintWatermark = 0x00000040

    EncryptDocument = 0x00000100

    EncryptDocument128 = 0x40000000

    EncryptDocument256 = 0x40000100

 

#Please check FileNameOptions for the complete flags version

 

# 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))

 

#Resulting PDF document stored here

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

 

#Set Printer options

[System.__ComObject].InvokeMember('FileNameOptionsEx',[System.Reflection.BindingFlags]::SetProperty,$null,$PDF,$acFileNameOptions::NoPrompt)

 

#Set Password to protect a PDF document and restricts users to viewing

[System.__ComObject].InvokeMember('Encryption',[System.Reflection.BindingFlags]::SetProperty,$null,$PDF,$ENCRYPTION::ENCRYPT_DOCUMENT) 

 

#Set OwnerPassword

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

 

#Set UserPassword

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

 

#Set Permissions

[System.__ComObject].InvokeMember('Permissions',[System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, $PERMISSIONS::NO_PERMISSION -bOr $PERMISSIONS::ENABLE_PRINTING)

 

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

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

 

#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

' Encryption constans

Const NO_ENCRYPTION = 0

Const ENCRYPT_DOCUMENT = 1

Const ENCRYPT_DOCUMENT128 = 2

Const ENCRYPT_DOCUMENT256 = 3

 

' Permissions

Const NO_PERMISSION = -64

Const ENABLE_PRINTING = 4

Const ENABLE_DOCUMENT_MODIFICATION = 8

Const ENABLE_COPYING_TEXT_GRAPHICS = 16

Const ENABLE_ADDING_CHANGING_NOTES = 32

 

' FileNameOptions constants

' Please check FileNameOptions for the complete flags version

Const NoPrompt = &H1

Const UseFileName = &H2

Const Concatenate = &H4

Const DisableCompression = &H8

Const EmbedFonts = &H10

Const BroadcastMessages = &H20

Const PrintWatermark = &H40

Const MultilingualSupport = &H80

Const EncryptDocument = &H100

Const EncryptDocument128 = &H40000000

Const EncryptDocument256 = &H40000100

 

' 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

 

' Resulting PDF document stored here

PDF.DefaultDirectory = "C:\Temp"

 

' Set Printer options

PDF.FileNameOptionsEx = NoPrompt

 

' Set Password to protect a PDF document and restricts users to viewing

PDF.Encryption = ENCRYPT_DOCUMENT

 

' Set OwnerPassword

PDF.OwnerPassword = "owner123"

 

' Set UserPassword

PDF.UserPassword = "user123"

 

' Set Permissions

PDF.Permissions = NO_PERMISSION + ENABLE_PRINTING

 

' Apply Settings

PDF.SetDefaultConfig

 

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

PDF.BatchConvert "C:\Temp\*.docx"

 

' 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