Функция DecryptFileW (winbase.h)
Расшифровывает зашифрованный файл или каталог.
Синтаксис
BOOL DecryptFileW(
[in] LPCWSTR lpFileName,
DWORD dwReserved
);
Параметры
[in] lpFileName
Имя расшифровки файла или каталога.
Вызывающий объект должен иметь права доступа FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTESи СИНХРОНИЗАЦИЯ. Дополнительные сведения см. в права доступа и безопасности файлов.
dwReserved
Скрытный; должно быть равно нулю.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ненулевое.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Функция DecryptFile требует монопольного доступа к расшифровке файла и завершится ошибкой, если другой процесс использует файл. Если файл не зашифрован, DecryptFile просто возвращает ненулевое значение, указывающее на успешность.
Если lpFileName указывает файл, доступный только для чтения, функция завершается ошибкой и GetLastError возвращает ERROR_FILE_READ_ONLY. Если lpFileName указывает каталог, содержащий файл только для чтения, функции выполняются успешно, но каталог не расшифровывается.
В Windows 8, Windows Server 2012 и более поздних версий эта функция поддерживается следующими технологиями.
| Технологии | Поддержанный |
|---|---|
| Протокол SMB 3.0 | Да |
| Отработка отказа SMB 3.0 (TFO) | Нет |
| SMB 3.0 с масштабируемыми общими папками (SO) | Нет |
| Файловая система общего тома кластера (CSVFS) | Нет |
| Отказоустойчивая файловая система (ReFS) | Нет |
SMB 3.0 не поддерживает EFS на общих ресурсах с возможностью непрерывной доступности.
Заметка
Заголовок winbase.h определяет DecryptFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winbase.h (включая Windows.h) |
| библиотеки |
Advapi32.lib |
| DLL | Advapi32.dll |
| набор API | ext-ms-win-advapi32-encryptedfile-l1-1-0 (представлено в Windows 8) |