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

Функция обратного вызова JET_PFNREALLOC

  • Статья

Применимо к: Windows | Windows Server

Функция обратного вызова JET_PFNREALLOC

Функция JET_PFNREALLOC — это обратный вызов, совместимый с realloc , используемый JetEnumerateColumns для выделения памяти для своих выходных буферов.

    void * JET_API JET_PFNREALLOC(
      [in]                 void* pvContext,
      [in]                 void* pv,
      [in]                 unsigned long cb
    );

Параметры

pvContext

Указатель контекста, заданный на JetEnumerateColumns. Этот указатель контекста можно использовать для передачи состояния от вызывающего объекта JetEnumerateColumns к реализации этого обратного вызова.

Pv

Если значение не равно NULL, указывает указатель на блок памяти, ранее выделенный этим обратным вызовом. Если значение РАВНО NULL, будет выделен новый блок памяти запрошенного размера.

Cb

Новый размер блока памяти в байтах. Если этот параметр равен 0 (нулю) и указан блок памяти, этот блок памяти будет освобожден.

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

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

Код возврата

Описание

Успешно

Если был указан ранее выделенный блок памяти и указан новый размер, равный нулю, этот блок освобождается и возвращается значение NULL. Если был указан ранее выделенный блок памяти и указан новый размер, отличный от нуля, возвращается перераспределенный блок памяти. Если блок памяти не указан, возвращается только что выделенный блок памяти указанного размера.

Failure

Возвращается значение NULL. Если был предоставлен ранее выделенный блок памяти, этот блок останется выделенным.

Требования

Требование Значение

Клиент

Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.

Сервер

Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.

Верхняя часть

Объявлено в Esent.h.

См. также:

JetEnumerateColumns