Функция OpenEncryptedFileRaw открывает зашифрованный файл с целью, чтобы резервировать (экспортировать) или восстановить (импортировать) файл. Это одна из группы функции Системы шифрования файлов (EFS), которая предназначается, чтобы осуществить функциональное назначение резервного копирования и восстановления, когда обслуживаемые файлы находятся в своем зашифрованном состоянии.
Синтаксис
DWORD OpenEncryptedFileRaw( LPCTSTR lpFileName, ULONG ulFlags, PVOID* pvContext ); |
Параметры
lpFileName
[in] Указатель на символьную строку с нулем ("0") в конце, которая именует открываемый файл. Строка должна состоять из букв или знаков символьного набора Windows.ulFlags
[in] Определяет выполняемую операцию. Этим параметром может быть одно из ниже перечисленных значений.
| Значение | Предназначение |
|---|---|
| 0 | Открывает файл для экспорта (резервное копирование). |
| CREATE_FOR_IMPORT | Файл открывается для импорта (восстановление). |
| CREATE_FOR_DIR | Импорт (восстановление) каталога, содержащего зашифрованные файлы. Флажок должен быть объединен с одним из предыдущих двух флажков, чтобы указать операцию. |
| OVERWRITE_HIDDEN | Переписывает при импорте скрытый файл. |
pvContext
[out] Адрес контекстного блока, который должен быть представлен при последующих вызовах ReadEncryptedFileRaw, WriteEncryptedFileRaw или CloseEncryptedFileRaw. Не изменяйте его.Возвращаемые значения
Если функция завершается успешно, она возвращает значение ERROR_SUCCESS.
Если функция завершается ошибкой, она возвращает ненулевой код ошибки, определяемый в winerror.h. Вы можете использовать функцию FormatMessage с флажком FORMAT_MESSAGE_FROM_SYSTEM, чтобы получить универсальное описание текста ошибки. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Вызывающая программа должна или иметь доступ для чтения или записи в файл, или она должна иметь привилегию резервирования SeBackupPrivilege на устройстве, на котором постоянно находятся файлы, чтобы вызов завершился успешно.
Чтобы резервировать зашифрованный файл, вызовите OpenEncryptedFileRaw, чтобы открыть его, а затем вызовите ReadEncryptedFileRaw. Когда резервное копирование закончится, вызовите CloseEncryptedFileRaw.
Чтобы восстановить зашифрованный файл, вызовите OpenEncryptedFileRaw, определяя в параметре ulFlags CREATE_FOR_IMPORT, а затем один раз вызовите WriteEncryptedFileRaw. Когда операция завершиться, вызовите функцию CloseEncryptedFileRaw.
Функция OpenEncryptedFileRaw завершается ошибкой, если lpFileName выходит за пределы количества символов MAX_PATH при открытии зашифрованного файла на удаленной машине.
Функции BackupRead и BackupWrite обрабатывают резервное копирование и восстановление незашифрованных файлов.
Смотри также
Обзор Шифрование файлов, Функции, используемые для шифрования файловой системой, BackupRead, BackupWrite, CloseEncryptedFileRaw, ReadEncryptedFileRaw, WriteEncryptedFileRaw
|
Размещение и совместимость OpenEncryptedFileRaw |
||
| К |
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 |
Нет |
|
| Замечания по платформе |
Не имеется |
|