Функция DuplicateEncryptionInfoFile (winefs.h)

Статья
11/20/2024

Копирует метаданные EFS из одного файла или каталога в другой.

Синтаксис

DWORD DuplicateEncryptionInfoFile(
  [in]           LPCWSTR                     SrcFileName,
  [in]           LPCWSTR                     DstFileName,
  [in]           DWORD                       dwCreationDistribution,
  [in]           DWORD                       dwAttributes,
  [in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Параметры

[in] SrcFileName

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

[in] DstFileName

Имя файла или каталога, в который копируются метаданные EFS.

Этот целевой файл или каталог не должен быть зашифрован перед вызовом этой функции; однако если эта функция успешно завершена, она будет зашифрована.

Если значение SrcFileName указывает файл, значение этого параметра также должно указывать файл и аналогично для каталогов. Если файл или каталог с именем, указанным этим параметром, не существует, создается файл или каталог (в зависимости от того, будет ли создан файл или каталог SrcFileName указывает файл или каталог).

[in] dwCreationDistribution

Описывает, как должен быть открыт целевой файл или каталог, определяемый значением параметра DstFileName. Ниже приведены допустимые значения этого параметра.

Ценность	Значение
CREATE_ALWAYS 2	Всегда создавайте целевой файл или каталог. Любое значение, переданное в этом параметре, отличное от CREATE_NEW, будет обработано как CREATE_ALWAYS.
CREATE_NEW 1	Создайте целевой файл или каталог, только если он еще не существует. Если он существует, и это значение указано, эта функция завершится ошибкой.

[in] dwAttributes

Атрибуты файла назначения или каталога. Атрибут FILE_READ_ONLY в настоящее время не обрабатывается этой функцией.

[in, optional] lpSecurityAttributes

Указатель на структуру SECURITY_ATTRIBUTES, указывающую атрибуты безопасности целевого файла или каталога, если он еще не существует. Если указать NULL, файл или каталог получает дескриптор безопасности по умолчанию. Списки управления доступом в дескрипторе безопасности по умолчанию для файла или каталога наследуются от родительского каталога.

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

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

Если функция завершается ошибкой, возвращаемое значение является системным кодом ошибки. Полный список кодов ошибок см. в разделе коды системных ошибок или файл заголовка WinError.h.

Замечания

Эксклюзивный доступ к целевому файлу или каталогу требуется EFS для вызова этой функции. Если этот доступ не предоставлен, эта функция завершится ошибкой.

Вызывающий объект должен иметь ключ EFS для исходного файла или каталога, а по крайней мере READ_ATTRIBUTE ACL исходного файла или каталога.

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

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

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

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

Требования

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

См. также

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

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

SECURITY_ATTRIBUTES

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