JET_RETRIEVECOLUMN-Struktur
Gilt für: Windows | Windows Server
JET_RETRIEVECOLUMN-Struktur
Die JET_RETRIEVECOLUMN-Struktur enthält Eingabe- und Ausgabeparameter für JetRetrieveColumns. Felder in der Struktur beschreiben, welcher Spaltenwert abgerufen werden soll, wie er abgerufen wird und wo Ergebnisse gespeichert werden.
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;
Member
Columnid
Der Spaltenbezeichner für die abzurufende Spalte.
pvData
Ein Zeiger zum Speichern von Daten, die aus dem Spaltenwert abgerufen werden.
cbData
Die Größe der Zuordnung ab pvData in Bytes. Der Vorgang zum Abrufen einer Spalte speichert nicht mehr Daten bei pvData als cbData.
cbActual
Die Größe der Daten in Bytes, die von einem Abrufspaltenvorgang abgerufen werden.
grbit
Eine Gruppe von Bits, die die Optionen für den Spaltenabruf enthalten, die null oder mehr der folgenden Werte enthalten.
Wert |
Bedeutung |
|---|---|
JET_bitRetrieveCopy |
Ruft den geänderten Wert anstelle des ursprünglichen Werts ab. Wenn der Wert nicht geändert wurde, wird der ursprüngliche Wert abgerufen. Auf diese Weise kann ein Wert abgerufen werden, der noch nicht eingefügt oder aktualisiert wurde, wenn ein Datensatz eingefügt oder aktualisiert wird. |
JET_bitRetrieveFromIndex |
Ruft Spaltenwerte nach Möglichkeit ohne Zugriff auf den Datensatz aus dem Index ab. Auf diese Weise kann unnötiges Laden von Datensätzen vermieden werden, wenn benötigte Daten aus Indexeinträgen selbst verfügbar sind. In Fällen, in denen der ursprüngliche Spaltenwert aufgrund von irreversiblen Transformationen oder Datenkürzungen nicht aus dem Index abgerufen werden kann, wird auf den Datensatz zugegriffen und die Daten wie gewohnt abgerufen. Dies ist eine Leistungsoption, die nur angegeben werden sollte, wenn der Spaltenwert wahrscheinlich aus dem Index abgerufen werden kann. Diese Option sollte nicht angegeben werden, wenn der aktuelle Index der gruppierte Index ist, da die Indexeinträge für den gruppierten oder primären Index die Datensätze selbst sind. Dieses Bit kann nicht festgelegt werden, wenn auch JET_bitRetrieveFromPrimaryBookmark festgelegt ist. |
JET_bitRetrieveFromPrimaryBookmark |
Ruft Spaltenwerte aus dem Indexlesezeichen ab und kann sich vom Indexwert unterscheiden, wenn eine Spalte sowohl im primären Index als auch im aktuellen Index angezeigt wird. Diese Option sollte nicht angegeben werden, wenn der aktuelle Index der gruppierte oder primäre Index ist. Dieses Bit kann nicht festgelegt werden, wenn JET_bitRetrieveFromIndex ebenfalls festgelegt ist. |
JET_bitRetrieveTag |
Ruft die Sequenznummer eines mehrwertigen Spaltenwerts in pretinfo-itagSequence> ab. Das Feld itagSequence wird häufig als Eingabe zum Abrufen von mehrwertigen Spaltenwerten aus einem Datensatz verwendet. Beim Abrufen von Werten aus einem Index ist es jedoch auch möglich, den Indexeintrag einer bestimmten Sequenznummer zuzuordnen und auch diese Sequenznummer abzurufen. Das Abrufen der Sequenznummer kann ein kostspieliger Vorgang sein und sollte nur bei Bedarf durchgeführt werden. |
JET_ bitRetrieveNull |
Ruft null-Werte für mehrwertige Spalten ab. Wenn diese Option nicht angegeben ist, werden null-Werte für mehrwertige Spalten automatisch übersprungen. |
JET_bitRetrieveIgnoreDefault |
Bewirkt, dass ein NULL-Wert zurückgegeben wird, wenn die angeforderte Sequenznummer 1 ist und keine festgelegten Werte für die Spalte im Datensatz vorhanden sind. Diese Option wirkt sich nur auf mehrwertige Spalten aus. |
JET_bitRetrieveLongId |
Dieses Flag dient nur zur internen Verwendung und ist nicht für die Verwendung in Ihrer Anwendung vorgesehen. |
JET_bitRetrieveLongValueRefCount |
Dieses Flag dient nur zur internen Verwendung und ist nicht für die Verwendung in Ihrer Anwendung vorgesehen. |
ibLongValue
Der Offset zum ersten Byte, das aus einer Spalte vom Typ JET_coltypLongBinary oder JET_coltypLongText abgerufen werden soll.
itagSequence
Die Sequenznummer der Werte, die in einer mehrwertigen Spalte enthalten sind. itagSequence hier im JET_RETRIEVECOLUMN kann 0 sein. Wenn itagSequence 0 ist, wird anstelle von Spaltendaten die Anzahl der Instanzen einer mehrwertigen Spalte zurückgegeben. Der itagSequence-Wert 0 kann nicht in Aufrufen von JetRetrieveColumn verwendet werden.
columnidNextTagged
Die Columnid der Spalte mit Tags, mehrwertigen Spalten oder Sparsespalten, wenn alle markierten Spalten abgerufen werden, indem 0 als columnid an JetRetrieveColumn übergeben wird.
err
Fehlercodes und Warnungen, die beim Abrufen der Spalte zurückgegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Kopfzeile |
Deklariert in Esent.h. |
Weitere Informationen
JET_COLTYP
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_RETRIEVECOLUMN
JetRetrieveColumn
JetRetrieveColumns