Wurde-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
Wurde-Funktion
Die Funktion wurde positioniert effizient einen Cursor auf einen Indexeintrag, der die vom Search-Schlüssel in diesem Cursor und dem angegebenen Zeichen angegebenen Suchkriterien entspricht. Ein Search-Schlüssel muss zuvor erstellte JetMakeKeyverwenden.
JET_ERR JET_API JetSeek(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_GRBIT grbit
);
Parameter
sesid
Die Sitzung für diesen Aufruf verwenden.
TableID
Der Mauszeiger für dieses Anrufs verwenden.
JET_errInvalidGrbit
Eine Gruppe von Bits an, die Optionen für dieses Anrufs zu verwendende enthalten. Jet_errinvalidgrbit muss ungleich NULL sein und muss eine oder mehrere der in der folgenden Tabelle aufgeführten Werte enthalten.
Wert |
Bedeutung |
|---|---|
JET_bitCheckUniqueness |
Ein spezielle Fehlercode JET_wrnUniqueKey, wird Wenn kostengünstig ermittelt werden kann, dass es genau ein Indexeintrag gibt entspricht, die die suchen-Taste zurückgegeben. Diese Option wird ignoriert, es sei denn, JET_bitSeekEQ ebenfalls angegeben ist. Diese Option ist nur auf Windows Server 2003 und spätere Versionen verfügbar. |
JET_bitSeekEQ |
Der Cursor wird bei der nächsten an den Anfang des Indexes Indexeintrag positioniert, die genau die suchen-Taste entspricht. Der Anfang des Indexes ist Indexeintrag, der gefunden wird, wenn zum ersten Datensatz im betreffenden Index zu verschieben. Starten des Index ist nicht identisch mit der niedrigste des Indexes, die abhängig von der Sortierreihenfolge der Schlüsselspalten im Index ändern können. Es ist nicht sinnvoll, verwenden Sie diese Option mit einem Suchschlüssel, die mit einem JetMakeKey mit einem Platzhalter-Option erstellt wurde. |
JET_bitSeekGE |
Der Cursor wird an die engsten an den Anfang des Indexes Indexeintrag platziert, die größer als oder gleich einen Indexeintrag, der die Suchkriterien entsprechen exakt übereinstimmen würde. Der Anfang des Indexes ist Indexeintrag, der gefunden wird, wenn zum ersten Datensatz im betreffenden Index zu verschieben. Starten des Index ist nicht identisch mit der niedrigste des Indexes, die abhängig von der Sortierreihenfolge der Schlüsselspalten im Index ändern können. Es ist nicht sinnvoll, verwenden Sie diese Option mit einem Suchschlüssel, die mit einem JetMakeKey mit einer Option Platzhalter für die direkte Verwendung Indexeinträge am Ende des Indexes finden erstellt wurde. |
JET_bitSeekGT |
Der Cursor wird an die engsten an den Anfang des Indexes Indexeintrag platziert, die größer als einen Indexeintrag ist, die die Suchkriterien entsprechen exakt übereinstimmen würde. Der Anfang des Indexes ist Indexeintrag, der gefunden wird, wenn zum ersten Datensatz im betreffenden Index zu verschieben. Starten des Index ist nicht identisch mit der niedrigste des Indexes, die abhängig von der Sortierreihenfolge der Schlüsselspalten im Index ändern können. Es ist nicht sinnvoll, verwenden Sie diese Option mit einem Suchschlüssel, die mit einem JetMakeKey mit einer Option Platzhalter für die direkte Verwendung Indexeinträge am nächsten an den Anfang des Indexes finden erstellt wurde. |
JET_bitSeekLE |
Der Cursor wird an die am Ende des Indexes Indexeintrag platziert, die kleiner als oder gleich einen Indexeintrag, der die Suchkriterien entsprechen exakt übereinstimmen würde. Das Ende der Index ist die Indexeintrag, der gefunden wird, wenn zum letzten Datensatz im betreffenden Index zu verschieben. Das Ende der Index ist nicht identisch mit high-End des Indexes, die abhängig von der Sortierreihenfolge der Schlüsselspalten im Index ändern können. Es ist nicht sinnvoll, verwenden Sie diese Option mit einem Suchschlüssel, die mit einem JetMakeKey mit einer Option Platzhalter für die direkte Verwendung Indexeinträge am nächsten an den Anfang des Indexes finden erstellt wurde. |
JET_bitSeekLT |
Der Cursor wird an die am Ende des Indexes Indexeintrag platziert, die kleiner als einen Indexeintrag ist, die die Suchkriterien entsprechen exakt übereinstimmen würde. Das Ende der Index ist die Indexeintrag, der gefunden wird, wenn zum letzten Datensatz im betreffenden Index zu verschieben. Das Ende der Index ist nicht identisch mit high-End des Indexes, die abhängig von der Sortierreihenfolge der Schlüsselspalten im Index ändern können. Es ist nicht sinnvoll, verwenden Sie diese Option mit einem Suchschlüssel, die mit einem JetMakeKey mit einer Option Platzhalter für die direkte Verwendung Indexeinträge am Ende des Indexes finden erstellt wurde. |
JET_bitSetIndexRange |
Ein Indexbereich werden automatisch Setup für alle Schlüssel, die die suchen-Taste exakt übereinstimmen. Der resultierende Indexbereich ist identisch mit eine, die andernfalls durch einen Aufruf von JetSetIndexRange mit den Optionen JET_bitRangeInclusive und JET_bitRangeUpperLimit erstellt worden wären. Weitere Informationen finden Sie unter JetSetIndexRange . Dies ist eine bequeme Methode zum ermitteln die Indexeinträge, die die gleichen den Suchkriterien entsprechen. Diese Option wird ignoriert, es sei denn, JET_bitSeekEQ ebenfalls angegeben ist. |
Return Value
Diese Funktion ermöglicht die Rückgabe von alle JET_ERRs , die in dieser API definiert sind. Weitere Informationen zu Fehlern von Jet finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. Für wurdebedeutet dies, dass ein Indexeintrag gefunden wurde, die mit die Suchkriterien entsprechen exakt übereinstimmen. |
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_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_errKeyNotMade |
Es ist kein aktuelle Suche-Schlüssel für den Cursor. Wurde erfordert, dass der Cursor gültige Suche Schlüssel, da es, die für die Suchkriterien zum Suchen von Indexeinträgen verwendet wird. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet wurde noch nicht initialisiert. |
JET_errRecordNotFound |
Kein Indexeintrag wurde gefunden, die mit die Suchkriterien übereinstimmen. |
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_wrnSeekNotEqual |
Ein Indexeintrag wurde gefunden, die mit die Suchkriterien übereinstimmen. Diese Indexeintrag war jedoch nicht über eine genaue Übereinstimmung. |
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_wrnUniqueKey |
Genau einen Indexeintrag gefunden, die die Suchkriterien entsprechen exakt übereinstimmen. Dieser Fehler wird nur zurückgegeben werden, wenn JET_bitSeekCheckUniqueness angegeben wurde, und es billig war, um zu bestimmen, dass der übereinstimmenden Indexeintrag der einzige Indexeintrag war, der mit die Suchkriterien übereinstimmt. Dieser Fehler wird nur von Windows Server 2003 und spätere Versionen zurückgegeben werden. |
Klicken Sie auf Erfolg wird der Cursor an einen Indexeintrag platziert, die den Suchkriterien entspricht. Wenn für die Aktualisierung ein Datensatzes vorbereitet wurde, wird die Aktualisierung abgebrochen werden. Wenn ein Indexbereich aktiviert ist, wird dieses Indexbereichs abgebrochen werden. Wenn ein Search-Schlüssel für den Cursor erstellt wurde, wird dieser Schlüssel Suche gelöscht werden. Keine Änderung an den Zustand der Datenbank erfolgt. Wenn mehrere Indexeinträge den gleichen Wert aufweisen, wird der Eintrag am nächsten an den Anfang des Indexes immer ausgewählt.
Bei einem Fehler wird die Position des Cursors unverändert bleiben, wenn JET_errRecordNotFound zurückgegeben wurde. In diesem Fall wird der Cursor positioniert, in dem der Indexeintrag, der vom Search-Schlüssel in diesem Cursor und dem angegebenen Zeichen angegebenen Suchkriterien hätte. Der Cursor kann relativ zum verschoben werden, dass Position aber immer noch nicht auf einen gültigen Index-Eintrag angezeigt wird. Wenn für die Aktualisierung ein Datensatzes vorbereitet wurde, wird die Aktualisierung abgebrochen werden. Wenn ein Indexbereich aktiviert ist, wird dieses Indexbereichs abgebrochen werden. Wenn ein Search-Schlüssel für den Cursor erstellt wurde, wird dieser Schlüssel Suche gelöscht werden. Keine Änderung an den Zustand der Datenbank erfolgt.
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_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetMakeKey
JetSetIndexRange
JetStopService