Функция ReadEncryptedFileRaw

Функция ReadEncryptedFileRaw используется, чтобы делать резервные копии (экспортировать) зашифрованных файлов. Она является одной из группы функции Системы шифрования файлов (EFS), которая предназначается, чтобы осуществить функциональное предназначение резервного копирования и  восстановления, в то время, когда обслуживаемые файлы находятся в своем зашифрованном состоянии.

Синтаксис

DWORD ReadEncryptedFileRaw(
  PFE_EXPORT_FUNC pfExportCallback,
  PVOID pvCallbackContext,
  PVOID pvContext
);

Параметры

pfExportCallback
[in] Указатель на экспортную функцию повторного вызова. Система вызывает функцию повторного вызова несколько раз, каждый раз, когда передается блок данных файла в функцию повторного вызова, до тех пор, пока весь файл не будет прочитан. Дополнительную информацию, см. в описании функции ExportCallback.
pvCallbackContext
[in] Указатель на определяемый программой и назначенный контекстный блок. Система передает этот указатель в функцию повторного вызова как параметр так, чтобы функция повторного вызова могла иметь доступ к конкретным для приложения данным. Это может быть структура и могут содержаться какие-либо данные, нужные приложению, такие как дескриптор файла, который будет содержать резервную копию зашифрованного файла.
pvContext
[in] Указатель на определяемый системой контекстный блок. Контекстный блок возвращается функцией OpenEncryptedFileRaw. Не изменяйте его.

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

Если функция завершается успешно, возвращаемое значение - 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

Нет

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz