JET_PFNREALLOC回调函数

适用于: Windows |Windows Server

JET_PFNREALLOC回调函数

JET_PFNREALLOC 函数是 JetEnumerateColumns 用于为其输出缓冲区分配内存的与本地兼容的回调。

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

parameters

pvContext

给定给 JetEnumerateColumns 的上下文指针。 此上下文指针可用于将 状态从 JetEnumerateColumns 的调用方传达到此回调的实现。

pv

如果不是 NULL,则指定指向以前由此回调分配的内存块的指针。 如果为 NULL,则会分配请求大小的新内存块。

cb

内存块的新大小(以字节为单位)。 如果此参数为 0 (零) 并且指定了内存块,则将释放该内存块。

返回值

由于调用此函数,系统可能会生成成功或失败代码。 有关如何将这些代码作为 HRESULT 返回的信息,请参阅 可扩展存储引擎错误

返回代码

说明

成功

如果指定了以前分配的内存块,并且指定了零的新大小,则释放该块并返回 NULL。 如果指定了以前分配的内存块,并且指定了非零的新大小,则返回重新分配的内存块。 如果未指定内存块,则返回指定大小的新分配的内存块。

失败

将返回 NULL。 如果提供了以前分配的内存块,则该块将保持已分配状态。

要求

要求

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 Professional。

服务器

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

标头

在 Esent.h 中声明。

另请参阅

JetEnumerateColumns