IacDocument.Encrypt128 Method

The Encrypt128 method secures the PDF document with 128-bit encryption and prevents it from unauthorized access. Two passwords, the owner password and user password, are associated to an encrypted PDF document.

 

Syntax

Visual Basic .NET:

Public Function Encrypt128(ownerPassword As String, userPassword As String, permissions As uint) As Boolean

C#:

public bool Encrypt128(string ownerPassword, string userPassword, uint permissions)

 

Parameters

ownerPassword

Owner password is the password for the author of the document.

The owner password is optional and allows the author having this password to do any operation he/she wishes on this document, including modifying its security settings. It can be blank, same password as the user, or a password different from the user.

userPassword

User password is the password for the destination or the user of the document.

The user password is optional and can be one of the following:

 

User Password Option

Description

A blank password

The user is not prompted for a password when opening a document, but is restricted to the operations allowed by the author.

The same password as the owner

The user is prompted for a password and the author of the document will not be able to open this document as an owner to change its security settings.

A password different from the owner

The user will not be able to open the document unless he/she enters a valid password. When a valid password is entered, the document can be viewed but its usage is `restricted to the operations allowed by the author.

The password dialog can be forced to appear if the SHIFT key is pressed while pressing the open bottom of the "File Open" dialog. This way, the application user can enter the owner password even if the user password is blank.

Options

Permissions to user:

 

Permission Type

Value (Hex)

Value (Dec)*

No permission.

0xFFFFF0C0

-3904

Enable Printing (low resolution)

0xFFFFF0C0 | 0x000004

-3904 + 4

Enable document modification, including document assembly.

0xFFFFF0C0 | 0x000008

-3904 + 8

Enable copying text and graphics, and support of accessibility to users with disabilities or for other purposes.

0xFFFFF0C0 | 0x000010

-3904 + 16

Enable adding and changing notes, and fill-in existing interactive form fields (including signature fields).

0xFFFF0C0 | 0x000020

-3904 + 32

Enable only fill-in existing interactive form fields (including signature fields).

0xFFFF0C0 | 0x000100

-3904 + 256

Enable extraction text and graphics (in support of accessibility to users with disabilities or for other purposes)

0xFFFF0C0 | 0x000200

-3904 + 512

Enable document assembly which includes: insert, rotate or delete pages and create bookmark or thumbnail images, but not document modification.

0xFFFF0C0 | 0x000400

-3904 + 1024

Enable High-Quality Printing, but the if "Enable Printing" has to be enabled.

0xFFFF0C0 | 0x000800

-3904 + 2048

(*) NOTE: Converting from HEX DWORD, unsigned and 32-bit unit of data

 

Remarks

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

To combine multiple options, use hexadecimal 0xFFFFF0C0 or decimal -3904 plus the values 4, 8, 16 or 32.

E.g. to enable both printing and adding notes, use hexadecimal 0xFFFFF0C0 | 0x000004 |  0x000020, or decimal -3904 + 4 + 32 = -28. To disable all 4 options, use hexadecimal 0xFFFFF0C0 or decimal -3904.

 

 

Member of AmyuniPDFCreator.IacDocument.