JetSetColumns-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetSetColumns-Funktion
Die Funktion JetSetColumns entspricht dem Verhalten JetSetColumn ermöglicht aber auch eine Anwendung in einem einzigen Vorgang mehrere Spaltenwerte festgelegt. Ein Array von JET_SETCOLUMN Strukturen wird zum Beschreiben der Spaltenwerte festgelegt werden soll, und klicken Sie zum Beschreiben der Eingabe-Puffer für jeden Wert von Column festgelegt werden soll.
JET_ERR JET_API JetSetColumns(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in_out_opt JET_SETCOLUMN* psetcolumn,
__in unsigned long csetcolumn
);
Parameter
sesid
Die Sitzung für diesen Aufruf verwenden.
TableID
Der Mauszeiger für dieses Anrufs verwenden.
psetcolumn
Ein Zeiger auf ein Array von Strukturen für eine oder mehrere JET_SETCOLUMN . Jede Struktur enthält Beschreibungen der welcher Spaltenwert festgelegt und woher zum Abrufen von Spaltendaten festlegen.
csetcolumn
Die Anzahl der JET_SETCOLUMN Strukturen in das Array von Psetcolumnangegeben.
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
---|---|
JET_errBadColumnId |
Die Spalten-ID angegeben wird, außerhalb der zulässigen Grenzen einer Spalte-ID. |
JET_errClientRequestToStopJetService |
Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf die Instanz der Sitzung zugeordnet aufgrund eines Aufrufs von JetStopServicebehoben ist. |
JET_errColumnIllegalNull |
Identisch mit JET_errNullInvalid. |
JET_errColumnNotFound |
Die Spalte, die durch die angegebenen Spalten-ID beschrieben ist in der Tabelle nicht vorhanden. |
JET_errColumnNotUpdatable |
Unzulässige versucht, einen long-Wert während einer Kopie löschen ursprünglichen Update Einfügevorgangs zu aktualisieren. |
JET_errColumnTooBig |
Die angegebene Spalte Wertdaten in den Puffer übersteigt die Größenbeschränkung für eine Spalte mit fester Länge natürlichen oder konfigurierten für feste Länge Text oder binär Spalten. Dieser Fehler wird auch zurückgegeben, wenn mehr als 1024 Bytes Daten für eine lange Spalte übergibt und Festlegen der JET_bitSetIntrinsicLV kennzeichnen. |
JET_errInstanceUnavailable |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet ein schwerwiegender Fehler, der erforderlich sind aufgetreten wurde, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen. Dieser Fehler wird nur von Windows XP und spätere Versionen zurückgegeben werden. |
JET_errInvalidBufferSize |
Die angegebene Spaltengröße stimmt nicht überein, was für den Datentyp feste Länge natürliche ist. |
JET_errInvalidColumnType |
Unzulässige es wurde versucht, einer Spalte automatische Inkrementierung aktualisiert werden, entweder beim Einfügen oder Aktualisierungsvorgang oder So aktualisieren Sie eine Spalte Version während eines Ersetzungsvorgangs. |
JET_errInvalidgrbit |
Die Optionen, die bereitgestellt sind unbekannt oder eine ungültige Kombination von bekannten Bit-Einstellungen. |
JET_errInvalidParameter |
Der angegebene Psetinfo -> CbStruct ist es sich nicht um eine gültige Größe für die JET_SETINFO -Struktur. |
JET_errMultiValuedDuplicate |
Die Spalte Operation hat versucht, einen doppelten Wert erstellen und JET_bitSetUniqueMultiValues oder JET_bitSetUniqueNormalizedMultiValues angegeben. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet wurde noch nicht initialisiert. |
JET_errNotInTransaction |
Unzulässige versucht, einen Spalte mit langen Wert aktualisieren, wenn die aufrufende Sitzung nicht in einer Transaktion war. |
JET_errNullInvalid |
Unzulässige versucht, eine nicht-NULL-Spalte auf NULL festgelegt. |
JET_errRecordTooBig |
Der Wert von Column konnte nicht auf den Wert im Puffer festgelegt werden, da er den Datensatz auf die Seite überschreiten geführt hätte Größe Uploaddatei beziehen. Spalten vom Typ JET_coltypLongText oder JET_coltypLongBinary können getrennt von den verbleibenden Daten gespeichert werden. Allerdings anderen Spalten müssen mit dem Datensatz gespeichert werden und können dazu führen, dass die Datensatz Größenbeschränkung überschritten werden. Auch lange Spalten erfordern 5-Byte Speicherplatz innerhalb des Datensatzes als eine Verknüpfung, und dies zu zu JET_errRecordTooBig zurückgegeben werden führen kann. |
JET_errRestoreInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da ein Restore-Vorgang in Arbeit auf die Instanz der Sitzung zugeordnet ist. |
JET_errSessionSharingViolation |
Die gleiche Sitzung kann nicht für mehrere Threads gleichzeitig verwendet werden. Dieser Fehler wird nur von Windows XP und spätere Versionen zurückgegeben werden. |
JET_errTermInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet heruntergefahren wird. |
JET_errUpdateNotPrepared |
Der Mauszeiger wird derzeit nicht beim Einfügen eines neuen Datensatzes oder Aktualisieren eines vorhandenen Datensatzes. |
JET_wrnColumnMaxTruncated |
Der Wert von Column im Puffer die konfigurierte maximale Länge einer Spalte mit variabler Länge überschritten und wurde abgeschnitten. |
Bei Erfolg für die einzelnen Spalten in der Psetcolumns beschriebenen wird mit Daten aus dem Puffer kopiert der gewünschte Teil der Spaltenwert festgelegt. Das DataSet Spalte wurde möglicherweise abgeschnitten, wenn er die maximale Länge für eine Spalte mit variabler Länge angegeben überschritten hat.
Bei einem Fehler die Cursorposition bleibt unverändert und keine Spaltendaten Wert werden in den Kopierpuffer aktualisiert.
Anmerkungen
Wenn alle individuellen Satz Spalte Vorgang einen Fehler zurückgegeben wird der gesamte Vorgang JetSetColumns einen Fehler zurück. Warnungen, sind im Allgemeinen im zurückgegebenen Fehler-die Psetcolumns > und nicht in der Rückgabecode von dieser Funktion. Jedoch, wenn die letzte Spalte Gruppe eine Warnung ausgegeben hat, werden diese Warnung aus JetSetColumns selbst 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. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Siehe auch
JET_COLTYP
JET_ERR
JET_SESID
JET_TABLEID
JET_SETCOLUMN
JetRetrieveColumns
JetSetColumn