функция обратного вызова PFE_EXPORT_FUNC (winbase.h)

Статья
08/27/2023

Определяемая приложением функция обратного вызова, используемая с 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)