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

  • Статья

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

Синтаксис

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

Параметры

[in] lpFileName

Имя файла.

[out] lpStatus

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

Значение Значение
FILE_ENCRYPTABLE
0
 Файл можно зашифровать.

Выпуски Windows Home, Home Premium, Starter и ARM: 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 Transparent Failover (TFO) Нет
SMB 3.0 с масштабируемыми общими папками (SO) Нет
Файловая система общего тома кластера (CSVFS) Нет
Восстанавливаемая файловая система (ReFS) Нет
 

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

Примечание

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

Требования

   
Минимальная версия клиента Windows XP Professional [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

EncryptFile

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

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