Функция DuplicateEncryptionInfoFile копирует метаданные файловой системы EFS из одного файла или каталога в другой.
Синтаксис
DWORD DuplicateEncryptionInfoFile( LPCTSTR SrcFileName, LPCTSTR DstFileName, DWORD dwCreationDistribution, DWORD dwAttributes, CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes ); |
Параметры
SrcFileName
[in] Указатель на символьную строку, которая устанавливает имя файла или каталога, из которого должны копироваться метаданные файловой системы шифрования (EFS). Этот исходный файл или каталог должны быть зашифрованы.DstFileName
[in] Указатель на символьную строку, которая устанавливает имя файла или каталога, в который метаданные файловой системы шифрования (EFS) должны копироваться.Этот принимающий файл или каталог не должны быть зашифрованы до вызова этой функции; однако, если эта функция завершается успешно, он должен быть зашифрован.
Если значение параметра SrcFileName определяет файл, величина этого параметра должна также задавать файл, и аналогично и для каталогов. Если файл или каталог с именем, указанным этим параметром не существуют, файл или каталог (в зависимости от того, что определяет параметр SrcFileName файл или каталог) должен быть создан.
dwCreationDistribution
[in] Характеризует, как принимающий файл или каталог, идентифицированные значением параметра DstFileName должны открыться. Ниже - допустимые значения этого параметра.| Значение | Предназначение |
|---|---|
| CREATE_ALWAYS | Всегда создает принимающий файл или каталог. Любое значение передаваемое в этом параметре иное чем CREATE_NEW должно обрабатываться как CREATE_ALWAYS. |
| CREATE_NEW | Создает принимающий файл или каталог только в том случае, если он еще не существует. Если он действительно существует, и это значение определено, эта функция завершится ошибкой. |
dwAttributes
[in] Атрибуты принимающего файла или каталога. Атрибут FILE_READ_ONLY в настоящий момент не обрабатывается этой функцией.lpSecurityAttributes
[in] Указатель на структуру SECURITY_ATTRIBUTES, которая устанавливает атрибуты защиты принимающего файла или каталога, если он еще не существует. Если Вы устанавливаете значение ПУСТО (NULL), файл или каталог получает заданный по умолчанию дескриптор безопасности. Списки контроля доступа (ACL) в заданном по умолчанию дескрипторе безопасности для файла или каталога наследуются от его родительского каталога.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение - код системной ошибки. Полный список кодов ошибок см. в статье Коды системных ошибок или в заголовочном файле WinError.h.
Замечания
Монопольный доступ к принимающему файлу или каталогу требуется файловой системе шифрования (EFS) для вызова этой функции. Если этот доступ не обеспечен, эта функция завершится ошибкой.
Вызывающая программа должна иметь ключ файловой системы шифрования (EFS) для исходного файла или каталога, и, по крайней мере, READ_ATTRIBUTE_ACL для исходного файла или каталога.
Заданный исходный и принимающий файл или каталог должны постоянно находиться в одном и том же компьютере; в противном случае будет возвращена ошибка.
Смотри также
Обзор Шифрование файлов, Функции, используемые для шифрования файловой системой, SECURITY_ATTRIBUTES
|
Размещение и совместимость DuplicateEncryptionInfoFile |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 |
Нет |
| и |
Windows NT |
Нет |
| е |
Windows Me |
Нет |
| н |
Windows 98 |
Нет |
| т |
Windows 95 |
Нет |
|
Нет |
||
| С |
Windows 2003 Server |
Да |
| е |
Windows 2000 Server |
Нет |
| р |
Windows NT Server |
Нет |
| в |
|
|
| е |
|
|
| р |
|
|
|
Используемая библиотека |
Advapi32.lib |
|
| Требуется DLL | - | |
|
Заголовочный файл |
||
|
- объявлено в |
Winefs.h |
|
|
- включено в |
Windows.h |
|
|
Unicode |
- |
|
|
Замечания по платформе |
Не имеется |
|