12 сент. 2010 г.

ExportCallback


Поддерживается на Windows Vista / XP / 2000Pro
ExportCallback – это определяемая приложением функция обратного вызова, используемая с ReadEncryptedFileRaw. Система вызывает ExportCallback один или более раз, и каждый раз с блоком зашифрованных данных файла, пока не закончатся все запрашиваемые данные. ExportCallback записывает зашифрованные данные файла на другое место хранения, обычно применяется для резервного копирования файла.

Тип PFE_EXPORT_FUNC определяет адрес функции обратного вызова. ExportCallback – это зарезервированное имя для функции обратного вызова.

DWORD WINAPI ExportCallback(
  PBYTE pbData,
  PVOID pvCallbackContext,
  ULONG ulLength
);

Параметры:
pbDataАдрес блока данных зашифрованного файла, куда они возвращаются. Этот блок данных выделяется системой.
pvCallbackContextАдрес определенного и выделенного приложением контекста блока. Приложение посылает адрес к ReadEncryptedFileRaw, и ReadEncryptedFileRaw отправляет этот адрес к функции обратного вызова, так что она может иметь доступ к определенных приложением данным. Эти данные могут быть структурой и могут содержать любые данные, которые нужны приложению, такие как дескриптор файла, какой содержит резервную копию зашифрованного файла.
ulLengthРазмер данных в байтах, на которые адресуется параметр pbData.

Возвращаемые значения:
Если функция успешна, возвращается значение ERROR_SUCCESS.

При ошибке, функция возвращает ненулевой код системной ошибки, который можно посмотреть в заголовочном файле WinError.h.
Замечания:
Вы можете воспользоваться определяемым приложением блоком контекста для внутреннего перемещения информации такой, как дескриптор файла и текущее смещение в файле.
Смотрите также:
ImportCallback, CloseEncryptedFileRaw, OpenEncryptedFileRaw, ReadEncryptedFileRaw, WriteEncryptedFile Raw