Функция 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 |
- |
|
| Замечания по платформе |
Не имеется |
|