12 сент. 2010 г.

EncryptionDisable


Поддерживается на Windows Vista / XP / 2000Pro
Функция EncryptionDisable отключает или включает шифрование в указанной директории и для файлов в ней. Она не имеет эффекта шифрования в поддиректориях, находящихся в указанной директории.

BOOL EncryptionDisable(
  LPCWSTR DirPath, // путь к директории
  BOOL Disable // отключить (TRUE) или включить (FALSE) шифрование
);

Параметры:
DirPathАдрес нульзаканчивающейся строки Unicode, которая определяет имя директории, в которой включается или отключается шифрование.
DisableОпределяет: будет шифрование отключено (TRUE) или включено (FALSE).

Возвращаемые значения:
Если вызов функции успешен, возвращается ненулевое значение.

При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызывайте GetLastError.
Замечания:
При нормальных условиях, EncryptFile не зашифровывает файлы и директории с установленным атрибутом FILE_ATTRIBUTE_SYSTEM. Можно стиреть атрибут FILE_ATTRIBUTE_SYSTEM и зашифровать файлы.

Если отправлено TRUE, EncryptionDisable запишет

[Encryption]
Disable=1

в файл Desktop.ini в директории (если его нет, он создается). Если секция уже существует, но Disable установлено 0, оно устанавливается в 1.

Пользователь может, также, сам добавлять или редактировать строки в файле Desktop.ini, что приведет к тому-же эффекту.

EncryptionDisable эффективна только для FileEncryptionStatus and EncryptFile. После зашифровки директории, любой новый файл и новая поддиректория, созданные без атрибута FILE_ATTRIBUTE_SYSTEM, будут зашифрованы.

Если отправлено TRUE, EncryptionDisable запишет

[Encryption]
Disable=0

и шифрование будет применено на файлы в этой директории.

Если вы попытаетесь использовать EncryptionDisable для установки директории в состояние, в котором она уже находится, функия завершится успешно, но не будет эффектна.

Если вы попытаетесь использовать EncryptionDisable для отключения или включения шифрования на файле, произойдет ошибка.
Смотрите также: