Функция OpenEncryptedFileRaw

Функция 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

Нет

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

Не имеется

 

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

Hosted by uCoz