JetGetLS-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetGetLS-Funktion
Die JetGetLS -Funktion ermöglicht der Anwendung abzurufende das Kontexthandle bekannt als lokaler Speicher, die mit einem Cursor oder die Tabelle, Cursor zugeordnet ist. Diese Kontexthandle muss zuvor eingestellten JetSetLSverwenden. JetGetLS können auch verwendet werden, gleichzeitig aktuelle Kontextnummer für ein Cursor oder eine Tabelle abrufen und diese Kontexthandle zurücksetzen.
Windows XP:JetGetLS wird in Windows XP eingeführt.
JET_ERR JET_API JetGetLS(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out JET_LS* pls,
__in JET_GRBIT grbit
);
Parameter
sesid
Die Sitzung für diesen Aufruf verwenden.
Tabellen-ID
Der Cursor für diesen Aufruf verwenden.
PLS
Der Ausgabepuffer, der aktuell den Cursor oder die Tabelle zugeordnete Kontextnummer empfängt.
JET_errInvalidGrbit
Eine Gruppe von Bits 0 (null) oder mehrere der folgenden Optionen angeben.
Wert |
Bedeutung |
---|---|
JET_bitLSCursor |
Gibt an, dass die existierenden Cursor zugeordnete Kontextnummer abgerufen werden soll. Wenn weder JET_bitLSCursor noch JET_bitLSTable angegeben ist, wird JET_bitLSCursor angenommen. Diese Option kann nicht mit JET_bitLSTable verwendet werden. Der Vorgang schlägt mit 0xFFFFFC7C fehl, wenn dies versucht wird. |
JET_bitLSTable |
Gibt an, dass die Kontext-Zugriffsnummer, die mit der Tabelle mit dem angegebenen Cursor abgerufen werden soll. Es ist unzulässig, diese Option mit JET_bitLSCursor verwenden. Der Vorgang schlägt mit 0xFFFFFC7C fehl, wenn dies versucht wird. |
JET_bitLSReset |
Gibt an, dass das Kontexthandle für das ausgewählte Objekt zu JET_LSNil zurückgesetzt werden sollen. Der Ausgabepuffer wird der aktuelle Wert der Kontextnummer zurückgegeben. |
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 |
Es ist nicht möglich, um den Vorgang abzuschließen, da alle Aktivitäten in der Instanz dieser Sitzung aufgrund eines Aufrufs von JetStopServiceeingestellt hat. |
JET_errInstanceUnavailable |
Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz ein schwerwiegender Fehler, der erfordert aufgetreten ist, 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äteren Versionen zurückgegeben werden. |
JET_errInvalidgrbit |
Eine der angeforderten Optionen ungültig in unzulässiger Weise verwendet oder nicht implementiert. Dies kann für JetGetLS auftreten, wenn sowohl JET_bitLSCursor als auch JET_bitLSTable festgelegt werden. |
JET_errLSNotSet |
Die Kontext-Zugriffsnummer konnte nicht zurückgegeben werden, da keine Kontexthandle derzeit das angeforderte Objekt zugeordnet ist. Hinweis Dieser Fehler wird nicht zurückgegeben, wenn JET_bitLSReset angegeben ist noch keine Kontexthandle das angeforderte Objekt zugeordnet ist. |
JET_errNotInitialized |
Es ist nicht möglich, um den Vorgang abzuschließen, da die Instanz dieser Sitzung noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Es ist nicht möglich, um den Vorgang abzuschließen, da ein Wiederherstellungsvorgang ausgeführt auf die Instanz der Sitzung zugeordnet wird. |
JET_errTermInProgress |
Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz heruntergefahren wird. |
Bei Erfolg wurde erfolgreich ein Handle für den Gerätekontext des angeforderten Objekts abgerufen. Wenn JET_bitLSReset angegeben wurde, diesen Kontext behandeln wurde erfolgreich aus dem Objekt entfernt. Keine Änderung an den Zustand der Datenbank erfolgt.
Bei einem Fehler ist keine Änderung am Status des angeforderten Objekts aufgetreten. Keine Änderung an den Zustand der Datenbank erfolgt.
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. |