JetRetrieveColumn-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetRetrieveColumn-Funktion

Die Funktion JetRetrieveColumn Ruft einen einspaltigen Wert aus dem aktuellen Datensatz. Der Datensatz ist dieser Datensatz verknüpft ist, mit dem Indexeintrag an der aktuellen Position des Cursors. Diese Funktion können Sie eine Spalte aus einem Datensatz in den Kopierpuffer Cursor erstellt abrufen. Diese Funktion kann auch Daten aus einem Indexeintrag abrufen, die auf den aktuellen Datensatz verweist. Zusätzlich zum Abrufen des aktuellen Spaltenwerts, können JetRetrieveColumn auch verwendet werden, zum Abrufen der Größe einer Spalte vor dem Abrufen der Spaltendaten selbst, damit Anwendung Puffer entsprechend vergrößert werden können.

JET_ERR JET_API JetRetrieveColumn(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in          JET_COLUMNID columnid,
  __out_opt     void* pvData,
  __in          unsigned long cbData,
  __out_opt     unsigned long* pcbActual,
  __in          JET_GRBIT grbit,
  __in_out_opt  JET_RETINFO* pretinfo
);

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

Tabellen-ID

Der Cursor für diesen Aufruf verwenden.

Spalten-ID

Die JET_COLUMNID der Spalte abgerufen.

Spalten-ID der Wert 0 (null) kann zugewiesen werden, die sich nicht auf eine einzelne Spalte bezieht. Spalten-ID 0 (null) angegeben wird, werden alle markierten Spalten mit geringer Dichte, und mehrwertige Spalten als einzelne Spalte behandelt. Dies erleichtert das Abrufen aller Spalten mit geringer Dichte, die in einem Datensatz vorhanden sind.

pvData

Der Ausgabepuffer, der Wert der Spalte empfängt.

cbData

Die maximale Größe des Ausgabepuffers in Bytes.

pcbActual

Empfängt die tatsächliche Größe der Wert der Spalte in Bytes.

Wenn dieser Parameter NULList, wird die tatsächliche Größe des Spaltenwerts nicht zurückgegeben werden.

JET_errInvalidGrbit

Eine Gruppe von Bits, die Optionen für diesen Aufruf enthalten die 0 (null) oder mehr der folgenden enthalten:

pretinfo

Wenn Pretinfo Geben Sie als NULL dann die Funktion verhält sich, als ob ein ItagSequence von 1 und ein IbLongValue von 0 (null) angegeben wurden. Dies bewirkt, dass Spalte abrufen, um den ersten Wert in einer Spalte mit mehreren Werten abzurufen, und zum Abrufen von long-Daten bei offset 0 (null).

Dieser Parameter wird verwendet, um eine oder mehrere der folgenden bereitzustellen:

Return Value

Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.

Bei Erfolg wird der Spaltenwert für die angegebene Spalte in den angegebenen Puffer kopiert. Kleiner als der Wert der Spalte wird mit der Warnung kopiert JET_wrnBufferTruncated zurückgegeben wird. Wenn die PcbActual erteilt wurde, wird die tatsächliche Größe des Spaltenwerts zurückgegeben. Hinweis Legen Sie die zurückgegebene Größe, dass NULL -Werte 0 (null) Länge und wird daher auf 0 (null). -> ItagSequence, wenn die Spalte abgerufen eine mehrwertige Spalte wurde Pretinfo erhielt und JET_bitReturnTag als eine Option festgelegt wurde, wird die laufende Nummer des Spaltenwerts in Pretinfo zurückgegeben.

Bei einem Fehler die Cursorposition bleibt unverändert, und keine Daten in den bereitgestellten Puffer kopiert.

Anmerkungen

Dieser Aufruf wird nur einmal zum Abrufen von Daten von festen oder bekannte Größe der Spalten nicht mit mehreren Werten verwendet. Jedoch Wenn Spaltendaten unbekannter Größe ist, wird dieser Aufruf in der Regel zweimal verwendet. Es heißt zunächst bestimmen Sie die Größe der Daten, damit sie den erforderlichen Speicherplatz zuordnen kann. Anschließend demselben Aufruf erfolgt zum Abrufen der Spaltendaten. Wenn die tatsächliche Anzahl der Werte bekannt ist, ist, da eine Spalte mit mehreren Werten ist, wird der Aufruf normalerweise dreimal verwendet. Zuerst, um die Anzahl der Werte zu, und klicken Sie dann zweimal mehr Speicher zuweisen und die tatsächlichen Daten abzurufen.

Abrufen aller Werte für eine Spalte mit mehreren Werte erfolgen kann, indem Sie wiederholt Aufrufen dieser Funktion mit einem Pretinfo -> ItagSequence-Wert beginnend bei 1 und bei jedem nachfolgenden Aufruf erhöhen. Der Wert der letzte Spalte bekanntermaßen abgerufen werden, wenn ein JET_wrnColumnNull aus der Funktion zurückgegeben wird. Hinweis, der diese Methode durchgeführt werden kann, wenn die mehrwertige Spalte explizit NULL hat Satz Werte in der Sequenz Wert, da diese Werte übersprungen werden würde. Wünscht eine Anwendung zum Abrufen von Werten für alle mehrwertige Spalte, einschließlich explizit auf NULLfestgelegt, muss JetRetrieveColumns anstelle von JetRetrieveColumnverwendet werden. Beachten Sie, dass diese Funktion die Anzahl von Werten für eine Funktion mit mehreren Werten nicht zurück, wenn ein ItagSequence -Wert von 0 (null) angegeben wird. Nur JetRetrieveColumns gibt die Anzahl der Werte eines Spaltenwerts zurück, wenn ein ItagSequence -Wert von 0 (null) übergeben wird.

Wenn diese Funktion auf Transaktionsebene 0 (null) aufgerufen wird, z. B. die aufrufende Sitzung ist selbst nicht in einer Transaktion, dann eine Transaktion geöffnet und geschlossen innerhalb der Funktion. Dies dient zurückzugebenden konsistente Ergebnisse in dem Fall, dass ein long-Wert Datenbankseiten umfasst. Beachten Sie, dass die Transaktion zwischen Funktionsaufrufen freigegeben und kann eine Reihe von Aufrufen dieser Funktion wird die Sitzung nicht in einer Transaktion Daten nach dem ersten Aufruf dieser Funktion aktualisiert.

Der Standardwert für die Spalte wird abgerufen, wenn die Spalte nicht explizit auf einen anderen Wert festgelegt wurde, wenn die Option JET_bitRetrieveIgnoreDefault festgelegt ist.

Wert der Autoincrement-Spalte abrufen, aus dem vorherigen Kopierpuffer gemeinsame Methode zur Identifizierung eines Datensatzes für die Bindung eindeutig beim Einfügen von Daten in mehrere Tabellen normalisiert, um einzufügen ist. Der Autoincrement-Wert wird zugewiesen, wenn der Einfügevorgang beginnt und aus dem Kopierpuffer kann, zu jeder Zeit abgerufen werden, bis die Aktualisierung abgeschlossen ist.

Wenn alle Spalten mit Tags, mit mehreren Werte und mit geringer Datendichte, Abrufen von Spalten-ID auf 0 (null) festlegen, werden Spalten in Columnid Reihenfolge von der niedrigsten Columnid zur höchsten Spalten-IDabgerufen. Die Reihenfolge der Spaltenwerte wird pro Zeitspalte zurückgegeben, wie Werte abgerufen werden. Die Reihenfolge ist deterministisch.

Voraussetzungen

Siehe auch

JET_COLUMNID
JET_ERR
JET_SESID
JET_TABLEID
JET_RETINFO
JetSetColumn
JetRetrieveColumns