Функция FileEncryptionStatusW (winbase.h)

Статья
11/20/2024

Извлекает состояние шифрования указанного файла.

Синтаксис

BOOL FileEncryptionStatusW(
  [in]  LPCWSTR lpFileName,
  [out] LPDWORD lpStatus
);

Параметры

[in] lpFileName

Имя файла.

[out] lpStatus

Указатель на переменную, которая получает состояние шифрования файла. Этот параметр может быть одним из следующих значений.

Ценность	Значение
FILE_ENCRYPTABLE 0	Файл можно зашифровать. home, Home Premium, Starter и ARM Editions of Windows: FILE_ENCRYPTABLE могут быть возвращены, но EFS не поддерживает шифрование файлов в этих выпусках Windows.
FILE_IS_ENCRYPTED 1	Файл зашифрован.
FILE_READ_ONLY 8	Файл — это файл, доступный только для чтения.
FILE_ROOT_DIR 3	Файл является корневым каталогом. Корневые каталоги не могут быть зашифрованы.
FILE_SYSTEM_ATTR 2	Файл является системным файлом. Системные файлы не могут быть зашифрованы.
FILE_SYSTEM_DIR 4	Файл является системным каталогом. Системные каталоги не могут быть зашифрованы.
FILE_SYSTEM_NOT_SUPPORT 6	Файловая система не поддерживает шифрование файлов.
FILE_UNKNOWN 5	Состояние шифрования неизвестно. Файл может быть зашифрован.
FILE_USER_DISALLOWED 7	Зарезервировано для дальнейшего использования.

Возвращаемое значение

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

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технологии	Поддержанный
Протокол SMB 3.0	Да
Отработка отказа SMB 3.0 (TFO)	Нет
SMB 3.0 с масштабируемыми общими папками (SO)	Нет
Файловая система общего тома кластера (CSVFS)	Нет
Отказоустойчивая файловая система (ReFS)	Нет

SMB 3.0 не поддерживает EFS на общих ресурсах с возможностью непрерывной доступности.

Заметка

Заголовок winbase.h определяет FileEncryptionStatus как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP Professional [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Advapi32.lib
DLL	Advapi32.dll

См. также

EncryptFile

шифрование файлов

функции управления файлами

Поделиться через