Struktur JET_RETINFO

Berlaku untuk: Windows | Windows Server

Struktur JET_RETINFO

Struktur JET_RETINFO berisi parameter input dan output opsional untuk JetRetrieveColumn. Penunjuk null dapat diteruskan di mana penunjuk ke struktur ini akan diteruskan. Meneruskan penunjuk null sama dengan meneruskan JET_RETINFO dengan cbStruct diatur ke sizeof(JET_RETINFO), ibLongValue diatur ke 0 (nol) dan itagSequence diatur ke 1.

    typedef struct {
      unsigned long cbStruct;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
    } JET_RETINFO;

Anggota

cbStruct

Harus diatur ke ukuran struktur JET_RETINFO , dalam byte, dan berfungsi untuk mengonfirmasi keberadaan bidang berikut.

ibLongValue

Offset ke byte pertama yang akan diambil dari kolom jenis JET_coltypLongBinary, atau JET_coltypLongText. Perhatikan bahwa jumlah data yang diambil dari offset ini adalah yang lebih rendah dari ukuran buffer output dan ukuran data dalam nilai aktual setelah offset ini.

itagSequence

Menjelaskan jumlah urutan nilai dalam kolom multinilai. Perhatikan bahwa array nilai berbasis satu. Nilai pertama adalah urutan 1, bukan 0. Jika kolom rekaman hanya memiliki satu nilai maka 1 harus diteruskan sebagai itagSequence

Dengan kolom yang dapat berisi beberapa nilai, hanya dimungkinkan untuk menggunakan nomor urut yang lebih besar dari 1 di JetSetColumn dan JetRetrieveColumn atau 0 di JetSetColumn. Dalam implementasi mesin saat ini, kolom apa pun yang dibuat dengan JET_bitColumnTagged dapat berisi beberapa nilai. Kolom yang dibuat dengan JET_bitColumnMultiValued berbeda dari kolom bertag multinilai hanya dengan cara kolom tersebut diindeks. Lihat JET_INDEXCREATE untuk informasi selengkapnya.

columnidNextTagged

Mengembalikan columnid dari kolom yang diberi tag, multinilai, atau jarang yang diambil, saat semua kolom yang ditandai diambil dengan meneruskan 0 sebagai columnid ke JetRetrieveColumn.

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_RETINFO
JetRetrieveColumn