Fungsi Panggilan Balik JET_PFNREALLOC

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Fungsi Panggilan Balik JET_PFNREALLOC

Fungsi JET_PFNREALLOC adalah panggilan balik kompatibel realloc yang digunakan oleh JetEnumerateColumns untuk mengalokasikan memori untuk buffer outputnya.

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

Parameter

pvContext

Penunjuk konteks yang diberikan kepada JetEnumerateColumns. Penunjuk konteks ini dapat digunakan untuk menyampaikan status dari pemanggil JetEnumerateColumns ke implementasi callback ini.

Jika non-NULL, menentukan penunjuk ke blok memori yang sebelumnya dialokasikan oleh panggilan balik ini. Jika NULL, blok memori baru dari ukuran yang diminta akan dialokasikan.

Ukuran baru blok memori dalam byte. Jika parameter ini adalah 0 (nol) dan blok memori ditentukan, blok memori tersebut akan dibebaskan.

Tampilkan Nilai

Sistem dapat menghasilkan kode keberhasilan atau kegagalan sebagai akibat dari panggilan ke fungsi ini. Untuk informasi tentang cara mengembalikan kode ini sebagai HRESULT, lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas.

Menampilkan kode	Deskripsi
Berhasil	Jika blok memori yang dialokasikan sebelumnya ditentukan dan ukuran baru nol ditentukan maka blok tersebut dibebaskan dan NULL akan dikembalikan. Jika blok memori yang dialokasikan sebelumnya ditentukan dan ukuran baru bukan nol ditentukan maka blok memori yang dialokasikan kembali. Jika tidak ada blok memori yang ditentukan maka blok memori yang baru dialokasikan dari ukuran yang ditentukan dikembalikan.
Kegagalan	NULL akan dikembalikan. Jika blok memori yang dialokasikan sebelumnya disediakan, blok tersebut akan tetap dialokasikan.

Menampilkan kode

Deskripsi

Berhasil

Jika blok memori yang dialokasikan sebelumnya ditentukan dan ukuran baru nol ditentukan maka blok tersebut dibebaskan dan NULL akan dikembalikan. Jika blok memori yang dialokasikan sebelumnya ditentukan dan ukuran baru bukan nol ditentukan maka blok memori yang dialokasikan kembali. Jika tidak ada blok memori yang ditentukan maka blok memori yang baru dialokasikan dari ukuran yang ditentukan dikembalikan.

Kegagalan

NULL akan dikembalikan. Jika blok memori yang dialokasikan sebelumnya disediakan, blok tersebut akan tetap dialokasikan.

Persyaratan

Persyaratan	Nilai
Klien	Memerlukan Windows Vista, Windows XP, atau Windows 2000 Professional.
Server	Memerlukan Windows Server 2008, Windows Server 2003, atau Windows 2000 Server.
Header	Dinyatakan dalam Esent.h.

Lihat juga

JetEnumerateColumns

Share via

Fungsi Panggilan Balik JET_PFNREALLOC