Freigeben über


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