DAOpenFileWithEncryptionKeyA

Керування документами, функції прямого доступу, безпека

Опис

Завершальна A позначає точку входу DLL для ANSI (char); поверхня ActiveX/COM надає лише форму Unicode. Поведінка ідентична DAOpenFileWithEncryptionKey, а рядкові аргументи інтерпретуються з використанням поточної кодової сторінки SetAnsiModeВідкриває зашифрований PDF для авторизованого відновлення чи дослідження, приймаючи шістнадцятковий ключ шифрування файлу безпосередньо замість виведення його з пароляФайл відкривається через дескриптор із джерелом лише для читання і не може доповнюватися на місці

Відкриває зашифрований PDF для авторизованого відновлення чи дослідження, приймаючи шістнадцятковий ключ шифрування файлу безпосередньо замість виведення його з пароля

Синтаксис

Delphi

Function DLDAOpenFileWithEncryptionKeyA(InstanceID: Integer; InputFileName, EncryptionKeyHex: PAnsiChar; Options: Integer): Integer; Stdcall;

DLL

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, щоб розрізнити перевірені та явно неперевірені дескрипториANSI-рядки розширюються до широких символів із поточною кодовою сторінкою

SetAnsiMode перед обробкою запитуКлюч є чутливим обліковим матеріалом, і його слід отримувати, передавати та зберігати з тими самими заходами контролю, що й пароль документа

Файл відкривається через дескриптор із джерелом лише для читання і не може доповнюватися на місці