Struktur JET_RETRIEVECOLUMN

Berlaku untuk: Windows | Windows Server

Struktur JET_RETRIEVECOLUMN

Struktur JET_RETRIEVECOLUMN berisi parameter input dan output untuk JetRetrieveColumns. Bidang dalam struktur menjelaskan nilai kolom apa yang akan diambil, cara mengambilnya, dan tempat menyimpan hasil.

    typedef struct {
      JET_COLUMNID columnid;
      void* pvData;
      unsigned long cbData;
      unsigned long cbActual;
      JET_GRBIT grbit;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
      JET_ERR err;
    } JET_RETRIEVECOLUMN;

Anggota

columnid

Pengidentifikasi kolom untuk diambil kolom.

pvData

Penunjuk untuk mulai menyimpan data yang diambil dari nilai kolom.

cbData

Ukuran alokasi yang dimulai pada pvData, dalam byte. Operasi ambil kolom tidak akan menyimpan lebih banyak data di pvData daripada cbData.

cbActual

Ukuran, dalam byte, data yang diambil oleh operasi ambil kolom.

grbit

Sekelompok bit yang berisi opsi untuk pengambilan kolom, yang menyertakan nol atau beberapa nilai berikut.

Nilai	Makna
JET_bitRetrieveCopy	Mengambil nilai yang dimodifikasi alih-alih nilai asli. Jika nilai belum dimodifikasi, maka nilai asli diambil. Dengan cara ini, nilai yang belum disisipkan atau diperbarui dapat diambil saat rekaman disisipkan atau diperbarui.
JET_bitRetrieveFromIndex	Mengambil nilai kolom dari indeks tanpa mengakses rekaman, jika memungkinkan. Dengan cara ini, pemuatan rekaman yang tidak perlu dapat dihindari ketika data yang diperlukan tersedia dari entri indeks itu sendiri. Dalam kasus di mana nilai kolom asli tidak dapat diambil dari indeks, karena transformasi atau pemotokan data yang tidak dapat diubah, rekaman akan diakses dan data diambil seperti biasa. Ini adalah opsi performa dan hanya boleh ditentukan ketika kemungkinan nilai kolom dapat diambil dari indeks. Opsi ini tidak boleh ditentukan jika indeks saat ini adalah indeks berkluster, karena entri indeks untuk indeks berkluster, atau primer, adalah rekaman itu sendiri. Bit ini tidak dapat diatur jika JET_bitRetrieveFromPrimaryBookmark juga diatur.
JET_bitRetrieveFromPrimaryBookmark	Mengambil nilai kolom dari marka buku indeks, dan dapat berbeda dari nilai indeks saat kolom muncul baik di indeks utama maupun indeks saat ini. Opsi ini tidak boleh ditentukan jika indeks saat ini adalah indeks terkluster, atau primer. Bit ini tidak dapat diatur jika JET_bitRetrieveFromIndex juga diatur.
JET_bitRetrieveTag	Mengambil nomor urut dari nilai kolom multinilai dalam pretinfo-itagSequence>. Bidang itagSequence sering digunakan input untuk mengambil nilai kolom multinilai dari rekaman. Namun, saat mengambil nilai dari indeks, dimungkinkan juga untuk mengaitkan entri indeks dengan nomor urutan tertentu dan mengambil nomor urutan ini juga. Mengambil nomor urut dapat menjadi operasi yang mahal dan hanya boleh dilakukan jika perlu.
JET_ bitRetrieveNull	Mengambil nilai NULL kolom multinilai. Jika opsi ini tidak ditentukan, nilai NULL kolom multinilai akan otomatis dilewati.
JET_bitRetrieveIgnoreDefault	Menyebabkan nilai NULL dikembalikan saat nomor urutan yang diminta adalah 1 dan tidak ada nilai yang ditetapkan untuk kolom dalam rekaman. Opsi ini hanya memengaruhi kolom multinilai.
JET_bitRetrieveLongId	Bendera ini hanya untuk penggunaan internal dan tidak dimaksudkan untuk digunakan dalam aplikasi Anda.
JET_bitRetrieveLongValueRefCount	Bendera ini hanya untuk penggunaan internal dan tidak dimaksudkan untuk digunakan dalam aplikasi Anda.

ibLongValue

Offset ke byte pertama yang akan diambil dari kolom jenis JET_coltypLongBinary atau JET_coltypLongText.

itagSequence

Jumlah urutan nilai yang terkandung dalam kolom multinilai. itagSequence di sini di JET_RETRIEVECOLUMN bisa 0. Jika itagSequence adalah 0, jumlah instans kolom multinilai dikembalikan alih-alih data kolom apa pun. Nilai itagSequence 0 tidak dapat digunakan dalam panggilan ke JetRetrieveColumn.

columnidNextTagged

Kolom kolom bertag, multinilai, atau jarang saat semua kolom yang ditandai diambil dengan meneruskan 0 sebagai columnid ke JetRetrieveColumn.

Err

Kode kesalahan dan peringatan yang dikembalikan dari pengambilan kolom.

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

JET_COLTYP
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_RETRIEVECOLUMN
JetRetrieveColumn
JetRetrieveColumns