EncryptFileA
امنیت و امضا
توضیحات
حرف پایانی A نقطهٔ ورود DLL یعنی ANSI (char) را نشان میدهد؛ سطح ActiveX/COM تنها فرم یونیکد را افشا میکند. رفتار با EncryptFile یکسان است و آرگومانهای رشتهای با code page فعلیِ SetAnsiMode تفسیر میشوند
فایلی روی دیسک را رمزنگاری کرده و نتیجه را در فایل جدیدی ذخیره میکند؛ لازم نیست کل سند در حافظه بارگذاری شود، پس این تابع برای رمزنگاری اسناد عظیم قابل استفاده است
نحو
Delphi
Function DLEncryptFileA(InstanceID: Integer; InputFileName, OutputFileName, Owner, User: PAnsiChar; Strength, Permissions: Integer): Integer;DLL
int DLEncryptFileA(int InstanceID, const char * InputFileName, const char * OutputFileName, const char * Owner, const char * User, int Strength, int Permissions);پارامترها
| InputFileName | نام فایل برای رمزنگاری |
|---|---|
| OutputFileName | نام فایل مقصد برای ساختن |
| Owner | گذرواژهٔ owner برای فایل رمزنگاریشده؛ این گذرواژه گاهی «master» یا «permissions» نامیده میشود و برای تغییر سند لازم خواهد بود. گذرواژهٔ user برای فایل رمزنگاریشده؛ این گذرواژه گاهی «open» نامیده میشود و به کاربر اجازه میدهد سند را باز کند اما نه استفاده از سند به شیوههای غیرمجاز |
| User | |
| Strength | قدرت رمزنگاری مورد استفاده: 0 = رمزنگاری 40 بیتی RC4 1 = رمزنگاری 128 بیتی RC4 2 = رمزنگاری 128 بیتی AES (نیازمند Acrobat 7 یا بعدتر) 3 = رمزنگاری 256 بیتی AES (نیازمند Acrobat 9 یا بعدتر) 4 = رمزنگاری 256 بیتی AES (نیازمند Acorbat X یا بعدتر) |
| Permissions | مقداری که با تابع EncodePermissions ساخته میشود |
مقادیر بازگشتی
| 0 | فایل رمزنگاری نشد؛ نتیجهٔ LastErrorCode را بررسی کنید |
|---|---|
| 1 | سند با موفقیت رمزنگاری شد |