Функция ReadEncryptedFileRaw используется, чтобы делать резервные копии (экспортировать) зашифрованных файлов. Она является одной из группы функции Системы шифрования файлов (EFS), которая предназначается, чтобы осуществить функциональное предназначение резервного копирования и восстановления, в то время, когда обслуживаемые файлы находятся в своем зашифрованном состоянии.
Синтаксис
DWORD ReadEncryptedFileRaw( PFE_EXPORT_FUNC pfExportCallback, PVOID pvCallbackContext, PVOID pvContext ); |
Параметры
Если функция завершается успешно, возвращаемое значение - ERROR_SUCCESS.
Если функция завершается ошибкой, она возвращает ненулевой код ошибки, определяемый в файле winerror.h. Вы можете использовать функцию FormatMessage с флажком FORMAT_MESSAGE_FROM_SYSTEM, чтобы получить универсальное описание текста ошибки. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Файл, который резервируется - не расшифровывается; его резервная копия делается в его зашифрованном состоянии.
Чтобы сделать резервную копию зашифрованного файла, вызовите функцию OpenEncryptedFileRaw, чтобы открыть файл. Затем вызовите функцию ReadEncryptedFileRaw, передавая её адрес определяемой программой экспортной функции повторного вызова. Система вызывает эту функцию повторного вызова, несколько раз до тех пор, пока не будет прочитано и резервировано содержание всего файла. Когда завершится резервное копирование, вызовите функцию CloseEncryptedFileRaw, чтобы освободить ресурсы и закрыть файл. Подробности о том, как объявить экспортную функцию повторного вызова см. в описании ExportCallback.
Чтобы восстановить зашифрованный файл, вызовите функцию OpenEncryptedFileRaw, определяя CREATE_FOR_IMPORT в параметре ulFlags. Затем вызовите WriteEncryptedFileRaw, передавая её адрес определяемой программой функции повторного вызова импорта. Система вызывает эту функцию повторного вызова, несколько раз до тех пор, пока не будет прочитано и восстановлено содержание всего файла. Когда восстановление завершится, вызовите функцию CloseEncryptedFileRaw, чтобы освободить ресурсы и закрыть файл. Подробности о том, как объявить импортную функцию повторного вызова см. описание ImportCallback.
Эта функция предназначается для резервного копирования только зашифрованных файлов; для резервного копирования незашифрованных файлов см. BackupRead.
Смотри также
Обзор Шифрование файлов, Функции, используемые для шифрования файловой системой, BackupRead, CloseEncryptedFileRaw, OpenEncryptedFileRaw, WriteEncryptedFileRaw
|
Размещение и совместимость ReadEncryptedFileRaw |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT |
Нет |
| е |
Windows Me |
Нет |
| н |
Windows 98 |
Нет |
| т |
Windows 95 |
Нет |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Нет |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Advapi32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Нет |
|
| Замечания по платформе |
Не имеется |
|