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
);
參數
pvCoNtext
提供給 JetEnumerateColumns的內容指標。 此內容指標可用來將 JetEnumerateColumns 呼叫端的狀態傳達至此回呼的實作。
光伏
如果為非 Null,請指定先前由這個回呼配置之記憶體區塊的指標。 如果為 Null,則會配置要求大小的新記憶體區塊。
cb
記憶體區塊的新大小,以位元組為單位。 如果此參數為 0 (零) 且指定記憶體區塊,則會釋放該記憶體區塊。
傳回值
系統可能會因為呼叫此函式而產生成功或失敗碼。 如需如何將這些代碼傳回為 HRESULT 的詳細資訊,請參閱 可延伸的儲存引擎錯誤。
傳回碼 |
描述 |
---|---|
Success |
如果已指定先前配置的記憶體區塊,並指定零的新大小,則會釋放該區塊,並傳回 Null。 如果已指定先前配置的記憶體區塊,並指定了非零的新大小,則會傳回重新配置記憶體區塊。 如果未指定任何記憶體區塊,則會傳回指定大小的新配置記憶體區塊。 |
失敗 |
Null 將會傳回。 如果已提供先前配置的記憶體區塊,該區塊仍會保持配置。 |
規格需求
需求 | 值 |
---|---|
用戶端 |
需要 Windows Vista、Windows XP 或 Windows 2000 Professional。 |
Server |
需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。 |
標頭 |
在 Esent.h 中宣告。 |