Функция EncryptionDisable


Функция 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.

Замечания по платформе

Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz