JET_RETRIEVECOLUMN-Struktur

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JET_RETRIEVECOLUMN-Struktur

Die JET_RETRIEVECOLUMN -Datenstruktur enthält Eingabe-und Ausgabeparameter für JetRetrieveColumns. Felder in der Struktur wird beschrieben, welche Spaltenwert abgerufen, wie Sie es abrufen und wo Ergebnisse zu speichern.

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;

Mitglieder

Spalten-ID

Der Spaltenbezeichner für die Spalte abgerufen.

pvData

Ein Zeiger auf beginnen, Speichern von Daten, die aus der Spaltenwert abgerufen werden.

cbData

Die Größe der Zuweisung beginnend bei PvDatain Byte. Der Vorgang abrufen Spalte wird nicht mehr Daten am PvData als CbDatagespeichert.

cbActual

Die Größe in Bytes der Daten, die mit einer Spalte abrufen-Operation abgerufen werden.

JET_errInvalidGrbit

Eine Gruppe von Bits an, die die Optionen für den Abruf von Spalte enthalten, die NULL oder mehrere der folgenden Werte enthalten.

Wert	Bedeutung
JET_bitRetrieveCopy	Der geänderten Wert anstelle der ursprüngliche Wert abgerufen. Wenn der Wert nicht geändert wurde, wird der ursprüngliche Wert abgerufen. Auf diese Weise kann ein Wert, der noch nicht eingefügt oder aktualisiert abgerufen werden, wenn ein Datensatz eingefügt oder aktualisiert wird.
JET_bitRetrieveFromIndex	Ruft Spaltenwerte aus dem Index ohne Zugriff auf den Datensatz, sofern möglich. Auf diese Weise kann unnötige Laden von Datensätzen vermieden werden, wenn die benötigte Daten aus Indexeinträge selbst verfügbar ist. In Fällen, in dem der ursprüngliche Wert von Column aufgrund nicht rückgängig gemacht werden Transformationen oder Abschneiden von Daten aus dem Index abgerufen werden kann nicht, der Datensatz zugegriffen wird, und die Daten wie gewohnt abgerufen. Dies ist eine Option für Leistung und sollte nur angegeben werden, wenn es wahrscheinlich ist, dass der Wert der Spalte aus dem Index abgerufen werden kann. Diese Option sollte nicht angegeben werden, wenn Sie der aktuelle Index gruppierten Index, seit die Indexeinträge für die gruppierten oder primäre, Index werden die Datensätze selbst. Dieses Bit kann nicht festgelegt werden, wenn auch JET_bitRetrieveFromPrimaryBookmark festgelegt ist.
JET_bitRetrieveFromPrimaryBookmark	Ruft Spaltenwerte aus dem Index Textmarke und kann unterscheiden sich von der Indexwert, wenn eine Spalte in der Primärindex und den aktuellen Index angezeigt wird. Diese Option sollte nicht bei der aktuelle Index der gruppierten oder primäre indizieren angegeben werden. Dieses Bit kann nicht festgelegt werden, wenn auch JET_bitRetrieveFromIndex festgelegt ist.
JET_bitRetrieveTag	Ruft die Sequenznummer einer Spalte mit mehreren Werten Wert in Pretinfo-ItagSequence >. Das Feld ItagSequence ist häufig eine Eingabe zum Abrufen von mehrwertigen Spaltenwerte aus einem Datensatz verwendet. Beim Abrufen von Werten aus dem Index ist es jedoch auch möglich, den Indexeintrag mit einer bestimmten Sequenznummer zuzuordnen und zu dieser Sequenznummer sowie abrufen. Abrufen der Sequenznummer kann ein Vorgang kostspieliger sein und sollte nur bei Bedarf durchgeführt werden.
JET_ bitRetrieveNull	Mehrwertige Spalte NULL-Werte abgerufen. Wenn diese Option nicht angegeben ist, werden automatisch mit mehreren Werten Spalte NULL-Werte übersprungen.
JET_bitRetrieveIgnoreDefault	Bewirkt, dass einen Nullwert zurückgegeben werden soll, wenn die angeforderte Sequenznummer 1 ist und keine Set-Werte für die Spalte im Datensatz vorhanden sind. Diese Option betrifft nur mehrwertige Spalten.
JET_bitRetrieveLongId	Dieses Kennzeichen ist nur zur internen Verwendung und ist nicht für die direkte Verwendung in Ihrer Anwendung verwendet werden.
JET_bitRetrieveLongValueRefCount	Dieses Kennzeichen ist nur zur internen Verwendung und ist nicht für die direkte Verwendung in Ihrer Anwendung verwendet werden.

ibLongValue

Der Offset des ersten Bytes aus einer Spalte vom Typ JET_coltypLongBinary oder JET_coltypLongTextabgerufen werden sollen.

itagSequence

Die laufende Nummer der Werte, die in einer Spalte mit mehreren Werten enthalten sind. ItagSequence hier in der JET_RETRIEVECOLUMN kann 0 sein. Wenn die ItagSequence 0 ist werden die Anzahl der Instanzen einer Spalte mit mehreren Werten anstatt alle Spaltendaten zurückgegeben. Ein ItagSequence Wert 0 kann nicht Aufrufe von JetRetrieveColumnverwendet werden.

columnidNextTagged

Die Spalten-ID der Spalte mit Tags, mit mehreren Werten oder wenige Wenn alle markierte Spalten abgerufen werden, indem JetRetrieveColumn0 als die Spalten-ID übergeben.

err

Fehlercodes und Warnungen, die von den Abruf der Spalte zurückgegeben.

Voraussetzungen

-Client,	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt.
Kopfzeile	In Esent.h deklariert.

Siehe auch

JET_COLTYP
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_RETRIEVECOLUMN
JetRetrieveColumn
JetRetrieveColumns