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

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

Синтаксис

BOOL FileEncryptionStatusA(
  [in]  LPCSTR  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

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

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