Windows Dev Center

Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetGotoSecondaryIndexBookmark-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

Die Funktion JetGotoSecondaryIndexBookmark positioniert einen Cursor auf einen Indexeintrag, der mit der Textmarke angegebenen sekundären Index verknüpft ist. Das sekundäre Index Lesezeichen muss mit demselben Index über dieselbe Tabelle verwendet werden von der ursprünglich abgerufen. Das sekundäre Index Lesezeichen für einen Indexeintrag kann mit JetGotoSecondaryIndexBookmarkabgerufen werden.

Windows XP:  JetGotoSecondaryIndexBookmark wird in Windows XP eingeführt.

JET_ERR JET_API JetGotoSecondaryIndexBookmark(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in          void* pvSecondaryKey,
  __in          unsigned long cbSecondaryKey,
  __in_opt      void* pvPrimaryBookmark,
  __in          unsigned long cbPrimaryBookmark,
  __in          const JET_GRBIT grbit
);

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

Tabellen-ID

Der Cursor für diesen Aufruf verwenden.

pvSecondaryKey

Der Puffer mit den sekundären Schlüssel zu verwenden, um den Cursor zu positionieren.

cbSecondaryKey

Die Größe des dem Sekundärschlüssel im Puffer.

pvPrimaryBookmark

Der Puffer, der das primäre-Lesezeichen verwenden enthält, um den Cursor zu positionieren.

cbPrimaryBookmark

Die Größe der primären Schlüssel Textmarke im Puffer.

JET_errInvalidGrbit

Eine Gruppe von Bits, die 0 (null) oder mehr der folgenden Optionen angibt.

Wert

Bedeutung

JET_bitBookmarkPermitVirtualCurrency

Das Ereignis positioniert, der Indexeintrag nicht mehr der Cursor bleibt werden kann gefunden, wo, Indexeintrag zuvor gefunden wurde. Der Vorgang wird noch mit JET_errRecordDeleted fehl; jedoch es ist möglich, auf den nächsten oder vorherigen Indexeintrag im Vergleich zu den Indexeintrag verschieben, wird nun, fehlt.

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.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf die Instanz, die mit der Sitzung ist, aufgrund eines Aufrufs von JetStopServiceeingestellt hat.

JET_errInstanceUnavailable

Der Vorgang kann nicht abgeschlossen werden, da ist, da die Instanz, die mit der Sitzung ist, ein schwerwiegender Fehler, die erfordert aufgetreten ist, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen.

Windows XP:  Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errInvalidBookmark

Sekundärer Index-Lesezeichen, das bereitgestellt wurde, war ungültig. Dieser Fehler könnte aufgetreten sind, da der sekundäre Schlüssel 0 (null ist) oder der sekundären Schlüssel Pufferzeiger NULL ist. Dieser Fehler tritt auf, weil

  • Der aktuelle sekundäre Index verfügt nicht über eine Eindeutigkeits-Integritätsregel und die Größe der angegebenen Textmarke ist 0 (null).

  • Der Lesezeichen-Pufferzeiger ist NULL.

JET_errNoCurrentIndex

Der Cursor ist derzeit nicht auf einem sekundären Index. Es ist nicht sinnvoll, zu einem sekundären Index Lesezeichen zu wechseln, wenn der Cursor derzeit keinen sekundären Index verwenden. JetGotoBookmark sollte verwendet werden, wenn der Cursor nicht auf ein Sekundärindex ist.

JET_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die mit der Sitzung ist, noch nicht initialisiert wurde.

JET_errRecordDeleted

Der Indexeintrag, der mit der Textmarke sekundärer Index verknüpft ist, konnte nicht gefunden werden.

JET_errRestoreInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, dem die Sitzung zugeordnet ist.

JET_errSessionSharingViolation

Die gleiche Sitzung kann für mehrere Threads gleichzeitig verwendet werden.

Windows XP:  Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da das Herunterfahren der Instanz, die die Sitzung zugeordnet ist.

Diese Funktion erfolgreich ist, wird der Cursor auf einen Indexeintrag positioniert, die die Textmarke angegebenen sekundären Index zugeordnet ist. Wenn Sie ein Datensatz für die Aktualisierung vorbereitet wurde, wird das Update abgebrochen. Wenn ein Index liegen im Bereich aktiviert ist, wird dieser Index liegen im Bereich abgebrochen. Wenn Suchschlüssel für den zu verwendenden Cursor erstellt wurde, wird diese Suche Schlüssel gelöscht werden. Keine Änderung an den Zustand der Datenbank erfolgt.

Wenn diese Funktion fehlschlägt, bleibt die Position des Cursors unverändert, wenn JET_errRecordDeleted zurückgegeben, und JET_bitBookmarkPermitVirtualCurrency wurde angegeben. In diesem Fall wird der Cursor positioniert werden, wo der Indexeintrag, der mit der Textmarke angegebenen sekundären Index verknüpft ist gewesen wäre. Der Cursor Bezug zu dieser Position verschoben werden kann, ist aber noch nicht auf einen gültigen Index-Eintrag.

Wenn Sie ein Datensatz für die Aktualisierung vorbereitet wurde, wird das Update abgebrochen. Wenn ein Index liegen im Bereich aktiviert ist, wird dieser Index liegen im Bereich abgebrochen. Wenn Suchschlüssel für den zu verwendenden Cursor erstellt wurde, wird diese Suche Schlüssel gelöscht werden. In jedem Fall erfolgt keine Änderung an den Zustand der Datenbank.

Voraussetzungen

-Client,

Erfordert Windows Vista oder Windows XP.

Server

Erfordert WindowsServer 2008 oder WindowsServer 2003.

Kopfzeile

In Esent.h deklariert.

Library

Verwenden Sie ESENT.lib.

DLL

"ESENT.dll" erfordert.

Siehe auch

Anzeigen:
© 2015 Microsoft