Функция EncryptionDisable запрещает или разрешает шифрование обозначенного каталога и файлов в нем. Она не влияет на шифрование подкаталогов ниже обозначенного каталога.
Синтаксис
BOOL EncryptionDisable( LPCWSTR DirPath, // имя каталога BOOL Disable // параметры шифрования ); |
Параметры
DirPath
[in] Указатель на строку Unicode с символом конца строки ('\0'), устанавливающую имя каталога, в котором разрешается или запрещается шифрование.Disable
[in] Обозначает, запрещено (TRUE) или разрешено (FALSE) шифрование.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
При обычных обстоятельствах функция EncryptFile не шифрует файлы и каталоги с установленным атрибутом FILE_ATTRIBUTE_SYSTEM. Она дает возможность отменить атрибут FILE_ATTRIBUTE_SYSTEM и зашифровать файлы. А также, если файл или каталог отмечены с атрибутом FILE_ATTRIBUTE_SYSTEM, они обычно невидимы для пользователя в перечнях файлов каталога и окнах каталога Проводника Windows. EncryptionDisable запрещает шифрование каталогов и файлов. Функция не влияет на видимость файлов с установленным атрибутом FILE_ATTRIBUTE_SYSTEM .
Если ИСТИНА (TRUE) передается в функцию EncryptionDisable, то должна быть запись
[Encryption] Disable=1 |
в файле Desktop.ini в каталоге (создающем его, если необходимо). Если раздел уже существует, а Disable (Запретить) установлен в 0, то он должен быть установлен в 1.
После того, как функция EncryptFile завершается ошибкой в каталоге и в его файлах , то код, который GetLastError возвращает, должен быть ERROR_DIR_EFS_DISALLOWED. Эта функция не влияет на шифрование подкаталогов внутри данной директории.
Пользователь может также самостоятельно добавить или отредактировать вышеупомянутые строки в файле Desktop.ini и инициировать одно и то же действие.
На функцию EncryptionDisable влияют только FileEncryptionStatus и EncryptFile. После того, как каталог зашифрован, любые новые файлы и новые подкаталоги, созданные без атрибута FILE_ATTRIBUTE_SYSTEM, должны быть зашифрованными.
Если в функцию EncryptionDisable передается значение ЛОЖЬ (FALSE), то должна быть запись
[Encryption] Disable=0 |
и разрешается шифрование файлов в этом каталоге.
Если Вы пробуете использовать EncryptionDisable, чтобы установить каталог в состояние, в котором он уже находится, функция завершается успешно, но не дает никакого результата.
Если Вы пробуете использовать EncryptionDisable, чтобы запретить или разрешить шифрование файла, попытка завершится ошибкой.
Смотри также
Обзор Шифрование файлов, Функции, используемые для шифрования файловой системой, DecryptFile, EncryptFile, FileEncryptionStatus, GetFileAttributes
Размещение и совместимость EncryptionDisable |
||
К |
Windows XP |
Да |
л |
Windows 2000 Professional |
Да |
и |
Windows NT |
Нет |
е |
Windows Me |
Нет |
н |
Windows 98 |
Нет |
т |
Windows 95 |
Нет |
С |
Windows 2003 Server |
Да |
е |
Windows 2000 Server |
Да |
р |
Windows NT Server |
Нет |
в |
|
|
е |
|
|
р |
|
|
Используемая библиотека |
Advapi32.lib |
|
Требуется DLL | - | |
Заголовочный файл |
||
- объявлено в |
Winefs.h |
|
- включено в |
Windows.h |
|
Unicode |
Реализуется как версии Unicode и ANSI. |
|
Замечания по платформе |
Не имеется |