JetGetCursorInfo-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetGetCursorInfo-Funktion
Die JetGetCursorInfo -Funktion wird verwendet, um festzustellen, ob ein Update des aktuellen Datensatzes eines Cursors zu einem Konflikt Write basierend auf den aktuellen Aktualisierungsstatus des Datensatzes führt. Es ist möglich, dass ein Konflikt Write letztlich zurückgegeben wird, auch wenn JetGetCursorInfo JET_errSuccess, zurückgegeben, da es sich bei einer anderen Sitzung den Datensatz aktualisieren kann, bevor die aktuelle Sitzung den gleichen Datensatz zu aktualisieren kann.
JET_ERR JET_API JetGetCursorInfo(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out void* pvResult,
__in unsigned long cbMax,
__in unsigned long InfoLevel
);
Parameter
sesid
Rufen Sie die Sitzung, die für diese verwendet werden.
TableID
Der Cursor, der für diesen Anruf verwendet werden.
pvResult
Für die zukünftige Verwendung reserviert.
cbMax
Muss auf 0 (null) ist, andernfalls nicht verwendete festgelegt sein. Es ist für künftige Funktionalität vorhanden.
InfoLevel
Muss auf 0 (null) ist, andernfalls nicht verwendete festgelegt sein. Es ist für künftige Funktionalität vorhanden.
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_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
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_errInvalidParameter |
Entweder CbMax ist nicht 0 (null) oder InfoLevel ist nicht 0 (null). |
JET_errNoCurrentRecord |
Der Mauszeiger wird derzeit nicht für einen Datensatz, und Informationen für einen logischen Datensatz kann nicht als Ergebnis zurückgegeben werden. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet wurde noch nicht initialisiert. |
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_errWriteConflict |
Der aktuelle Datensatz des Cursors wurde von einer anderen Sitzung aktualisiert, und ein Update dieses Datensatzes von dieser Sitzung führt zu einem Schreibkonflikt. |
Auf Erfolg dieser Vorgang hat keine Auswirkungen auf die Position des Cursors jedoch nur gibt an, dass keine anderen Sitzung derzeit dieser Datensatz aktualisiert hat.
Bei einem Fehler, wenn eine negative Fehlercode sind es keine Effekte an der Cursorposition oder der Datenbank.
Anmerkungen
Dieser Vorgang wirkt sich nicht auf den Status des Cursors oder die Daten aus. Es gibt nur einen Fehlercode beschreibt, ob ein Update für den aktuellen Datensatz von der aufrufenden Sitzung bekannt ist, dass eine JET_errWriteConflict führen, oder unbekannt ist zurückzugebenden JET_errWriteConflict zurück. Dieser Eintrag für dessen Verwendung bereits in einer anderen Sitzung aktualisiert hat ist sicher, dass ein Update dieses Datensatzes von dieser Sitzung ein Schreibzugriff Konflikt verursacht werden. Dies ist true, bis dieser Sitzung ein Commit oder ein Rollback für die Transaktionen auf Transaktionsebene 0 (null). Wenn JetGetCursorInfo JET_errSuccess zurückgibt, zwar für eine andere Sitzung diesen Eintrag vor der aktuellen Sitzung aktualisieren und daher ist es immer noch möglich, dass ein Update des aktuellen Datensatzes von dieser Sitzung in die aktuelle Transaktion zu einem Konflikt Write führt.
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_SESID
JET_TABLEID
JetGetLock
JetPrepareUpdate
JetStopService
JetUpdate