DAOpenFileWithEncryptionKey
Керування документами, функції прямого доступу, безпека
Опис
Відкриває зашифрований PDF для авторизованого відновлення чи дослідження, приймаючи шістнадцятковий ключ шифрування файлу безпосередньо замість виведення його з пароляФайл відкривається через дескриптор із джерелом лише для читання і не може доповнюватися на місці
Відкриває зашифрований PDF для авторизованого відновлення чи дослідження, приймаючи шістнадцятковий ключ шифрування файлу безпосередньо замість виведення його з пароля
Синтаксис
Delphi
Function TPDFlib.DAOpenFileWithEncryptionKey(Const InputFileName, EncryptionKeyHex: WideString; Options: Integer = 0): Integer;DLL
int DLDAOpenFileWithEncryptionKey(int InstanceID, const wchar_t * InputFileName, const wchar_t * EncryptionKeyHex, int Options);
int DLDAOpenFileWithEncryptionKeyA(int InstanceID, const char * InputFileName, const char * EncryptionKeyHex, int Options);Параметри
| InputFileName | Шлях і назва зашифрованого PDF |
|---|---|
| EncryptionKeyHex | Шістнадцятковий ASCII-ключ парної довжини без префікса та пробільних символів; редакції з 2 по 4 вимагають точну довжину ключа, оголошену словником шифрування, а редакції з 5 по 7 — 32 байти |
| Options | Нуль вимагає наявного верифікатора; PDF_RAW_KEY_ALLOW_UNVERIFIED дозволяє інакше дійсний ключ лише тоді, коли документ не має придатного верифікатора |
Повернуті значення
| Non-zero | Дескриптор файлу Direct Access |
|---|---|
| 0 | Вхідні дані не вдалося відкрити; перевірте LastErrorCode, зокрема PDFLIB_ERROR_RAW_ENCRYPTION_KEY_INVALID для недійсного синтаксису, довжини, опцій чи перевірки |
Примітки
Наявні значення /U редакцій з 2 по 4 та значення /Perms редакцій з 5 по 7 перевіряються завжди; PDF_RAW_KEY_ALLOW_UNVERIFIED ніколи не приймає невідповідністьПісля відкриття викличте
DAGetEncryptionKeyValidation, щоб розрізнити перевірені та явно неперевірені дескрипториКлюч є чутливим обліковим матеріалом, і його слід отримувати, передавати та зберігати з тими самими заходами контролю, що й пароль документа
Файл відкривається через дескриптор із джерелом лише для читання і не може доповнюватися на місці