функция обратного вызова PFE_EXPORT_FUNC (winbase.h)
Определяемая приложением функция обратного вызова, используемая с ReadEncryptedFileRaw. Система вызывает ExportCallback один или несколько раз, каждый раз с блоком данных зашифрованного файла, пока не получит все данные файла. ExportCallback записывает данные зашифрованного файла на другой носитель хранилища, как правило, для резервного копирования файла.
Тип PFE_EXPORT_FUNC определяет указатель на функцию обратного вызова. ExportCallback — это заполнитель для имени функции, определяемой приложением.
Синтаксис
PFE_EXPORT_FUNC PfeExportFunc;
DWORD PfeExportFunc(
[in] PBYTE pbData,
[in, optional] PVOID pvCallbackContext,
[in] ULONG ulLength
)
{...}
Параметры
[in] pbData
Указатель на блок данных зашифрованного файла для резервного копирования. Этот блок данных выделяется системой.
[in, optional] pvCallbackContext
Указатель на определяемый приложением и выделенный блок контекста. Приложение передает этот указатель в ReadEncryptedFileRaw, а ReadEncryptedFileRaw передает этот указатель функции обратного вызова, чтобы иметь доступ к данным конкретного приложения. Эти данные могут быть структурой и могут содержать любые данные, необходимые приложению, например дескриптор файла, который содержит резервную копию зашифрованного файла.
[in] ulLength
Размер данных, на которые указывает параметр pbData , в байтах.
Возвращаемое значение
Если функция завершается успешно, она должна задать для возвращаемого значения значение ERROR_SUCCESS.
Если функция завершается сбоем, задайте для возвращаемого значения ненулевой код ошибки, определенный в WinError.h. Например, если эта функция завершается сбоем из-за сбоя ВЫЗЫВАемого API, можно задать значение, возвращаемое командой GetLastError для API, завершившемся сбоем.
Комментарии
Определяемый приложением контекстный блок можно использовать для внутреннего отслеживания информации, такой как дескриптор файла и текущее смещение в файле.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winbase.h (включая Windows.h) |