Функция ExportCallback

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

Тип данных PFE_EXPORT_FUNC определяет указатель на функцию повторного вызова. ExportCallback - это имя - заместитель для определяемого программой имени функции.

Синтаксис

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

Параметры

pbData

[in] Указатель на блок данных зашифрованного файла, которые будут резервироваться. Этот блок данных назначается системой.

pvCallbackContext

[in] Указатель на определяемый программой и назначенный контекстный блок. Приложение переправляет этот указатель в функцию ReadEncryptedFileRaw, а ReadEncryptedFileRaw передает этот указатель в функцию повторного вызова так, чтобы она могла иметь доступ к конкретным для приложения данным. Это данные могут быть структурой и могут содержать любые данные необходимые приложению, такие как дескриптор файла, который содержит резервную копию зашифрованного файла.

ulLength

[in] Размер данных, на которые указывает параметр pbData, в байтах.

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

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

Если функция завершается ошибкой, она устанавливает возвращаемое значение в ненулевой код ошибки, определенный в WinError.h. Например, если эта функция завершается ошибкой, потому что API, который ее вызвал, завершается ошибкой, то Вы можете установить возвращаемое значение в величину, которую возвращает функция GetLastError для этой ошибки API.

Замечания

Вы можете использовать определяемый программой контекстный блок для внутреннего отслеживания информации, типа дескриптора файла и текущего смещения в файле.

Смотри также

Обзор Шифрование файловФункции, используемые для шифрования файловой системойImportCallback, CloseEncryptedFileRaw, OpenEncryptedFileRaw, ReadEncryptedFileRaw, WriteEncryptedFileRaw

Размещение и совместимость ExportCallback

К Windows XP Да с SP1
л Windows 2000 Professional Да 
и Windows NT Нет
е Windows Me Нет
н Windows 98 Нет
т Windows 95 Нет
 
С

Windows 2003 Server

Да
е

Windows 2000 Server

Да 
р

Windows NT    Server

Нет
в

 

 
е

 

 
 р

 

 

Используемая библиотека

-

Требуется библиотека -

Заголовочный файл

 
 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

-

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

Не имеется

 

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

Hosted by uCoz