status = doc:SetEncryptionMode(mode[, keylen])
doc:SetEncryptionMode()
setzt den Verschlüsselungsmodus.
Als Nebeneffekt erhöht es die Version von PDF auf 1.4, wenn
der Modus auf #HPDF_ENCRYPT_R3
gesetzt ist.
Die folgenden Verschlüsselungsmodi werden derzeit unterstützt:
#HPDF_ENCRYPT_R2:
keylen
wird automatisch
auf 5 (40 Bit) gesetzt.
#HPDF_ENCRYPT_R3:
keylen
kann 5 (40 Bit)
bis 16 (128 Bit) betragen.
Wenn doc:SetEncryptionMode()
erfolgreich ist, gibt er #HPDF_OK
zurück. Andernfalls wird ein Fehlercode zurückgegeben und der
Fehler-Handler wird aufgerufen.
#HPDF_ENCRYPT_R3
(voreingestellt ist 5, z.B. 40 bits)#HPDF_INVALID_DOCUMENT
- Es wurde eine ungültige Dokumenten-Kennung gesetzt.
#HPDF_INVALID_ENCRYPT_KEY_LEN
- Es wurde eine ungültige Schlüssellänge angegeben.
#HPDF_FAILED_TO_ALLOC_MEM
- Speicherzuordnung ist fehlgeschlagen.