DynaPDF Manual - Page 580

Previous Page 579   Index   Next Page 581

Function Reference
Page 580 of 839
OpenOutputFileEncrypted
Syntax:
LBOOL pdfOpenOutputFileEncrypted(
const PPDF* IPDF,
// Instance pointer
const char* OutPDF,
// The output file that should be opened
const char* OpenPwd,
// Optional open password
const char* OwnerPwd,
// Optional owner password (should be set)
TKeyLen KeyLen,
// Encryption key length
TRestrictions Restrict) // Restriction flags (see below)
typedef enum
{
kl40bit
= 0, // RC4 Encryption -> PDF 1.2, Acrobat 3 or higher
kl128bit
= 1, // RC4 Encryption -> PDF 1.4, Acrobat 5 or higher
kl128bitEx = 2, // RC4 Encryption -> PDF 1.5, Acrobat 6 or higher
klAES128
= 3, // AES Encryption -> PDF 1.6, Acrobat 7 or higher
klAES256
= 4, // AES Encryption -> PDF 1.7, Acrobat 9 or higher
klAESRev6
= 5
// AES Encryption -> PDF 2.0, Acrobat X or higher
}TKeyLen;
typedef SI32 TRestrictions;
#define rsDenyNothing
0x00000000 // Encrypt the file only
#define rsDenyAll
0x00000F3C // Deny anything
#define rsPrint
0x00000004 // Deny printing
#define rsModify
0x00000008 // Deny modification of contents
#define rsCopyObj
0x00000010 // Deny copying of contents
#define rsAddObj
0x00000020 // No commenting
/* 128/256 bit encryption only -> ignored if 40 bit encryption is used */
#define rsFillInFormFields 0x00000100 // requires rsModify + rsAddObj
#define rsExtractObj
0x00000200 // requires rsModify
#define rsAssemble
0x00000400 // requires rsModify
#define rsPrintHighRes
0x00000800 // Disable high res. printing
#define rsExlMetadata
0x00001000 // PDF 1.5 Exclude metadata streams
#define rsEmbFilesOnly
0x00002000 // PDF 1.6 AES Encryption only
The function opens the output file and sets the encryption parameters. This function enables in
combination with FlushPages() the creation of very large encrypted PDF files with minimal memory
usage.
The function can be called in a while statement, e.g. to display a open file dialog if the file could not
be opened. Once the function succeeds the PDF file can be finished with CloseFile().
Remarks:
This function is implemented in an Ansi and Unicode compatible version. Unicode paths are
converted to UTF-8 on non-Windows operating systems.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
 

Previous topic: OpenOutputFile

Next topic: OpenTag