Поделиться через


функция обратного вызова 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)

См. также раздел

CloseEncryptedFileRaw

Шифрование файлов

Функции управления файлами

ImportCallback

OpenEncryptedFileRaw

ReadEncryptedFileRaw

WriteEncryptedFileRaw