DuplicateEncryptionInfoFile

Поддерживается на Windows Vista / XP

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

DWORD DuplicateEncryptionInfoFile(
  LPCTSTR SrcFileName,
  LPCTSTR DstFileName,
  DWORD dwCreationDistribution,
  DWORD dwAttributes,
  const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Параметры:

SrcFileName	Адрес строки, которая определяет имя файла или директории, из которой будут скопированы метаданные EFS. Файл- или директория-источник должен быть зашифрован.
DstFileName	Адрес строки, которая определяет имя файла или директории, в которую будут скопированы метаданные EFS. Этот файл- или директория-назначение не являются зашифрованными перед вызовом функции, тем не менее, если функция успешно завершится, они будут зашифрованными. Если значение SrcFileName определяет файл, значение этого параметра также должно определять файл, так же само и для директорий. Если файла или директории с этим именем не существует, то файл или директория (в зависимости от того, что определяется в SrcFileName) будет создана.
dwCreationDistribution	Описывает, как файл- или директория-назначение, указанный в параметре DstFileName, будет открыт. Ниже представлены значения этого параметра: Значение: Описание: CREATE_ALWAYS Всегда создавать файл- или директорию-назначение. Всякое другое значение в этом параметре, кроме как CREATE_NEW, будет определятся как CREATE_ALWAYS. CREATE_NEW Создавать файл- или директорию-назначение только, если он уже не существует. Если не существует, и это значение не указано, то функция завершится с ошибкой.
dwAttributes	Файловые атрибуты файла- или директории-назначения. Атрибут FILE_READ_ONLY не обрабатывается этой функцией.
lpSecurityAttributes	Адрес структуры SECURITY_ATTRIBUTES, которая определяет атрибуты защиты файла- или директории-назначение, если они (атрибуты) уже не существуют. Если вы укажите NULL, файл или директория получит дескриптор безопасности по умолчанию. ACL в дескриптору безопасности по умолчанию для файла или директории, наследуется от родительской директории.

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

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

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

Замечания:

Для вызова этой функции, EFS требует эксклюзивный доступ к файлу- или директории-назначение.

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

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

Смотрите также:

SECURITY_ATTRIBUTES