JetDupSession-Funktion
Gilt für: Windows | Windows Server
JetDupSession-Funktion
Die JetDupSession-Funktion startet eine Sitzung und initialisiert ein ESE-Sitzungshandle (JET_SESID). Sitzungen steuern den gesamten Zugriff auf die Datenbank und werden zum Steuern des Transaktionsumfangs verwendet. Die Sitzung kann zum Starten, Committen oder Abbrechen von Transaktionen verwendet werden. Die Sitzung wird auch zum Anfügen, Erstellen oder Öffnen einer Datenbank verwendet. Die Sitzung wird als Kontext für alle DDL- und DML-Vorgänge verwendet. Um die Parallelität und den parallelen Zugriff auf die Datenbank zu erhöhen, können mehrere Sitzungen gestartet werden.
Hinweis Diese API fungiert in jeder Hinsicht als JetBeginSession, die für die instanz der übergebenen Sitzung aufgerufen wird. Diese Funktion wird nicht empfohlen, JetBeginSession wird bevorzugt.
JET_ERR JET_API JetDupSession(
__in JET_SESID sesid,
__out JET_SESID* psesid
);
Parameter
sesid
Die Sitzung, die als Quelle zum Duplizieren oder Beginnen der Sitzung verwendet werden soll.
psesid
Ein Zeiger auf die Variable, die das Sitzungshandle bei erfolgreicher Rückgabe initialisiert.
Rückgabewert
Diese Funktion gibt den JET_ERR Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.
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 der Instanz, die der Sitzung zugeordnet ist, als Ergebnis eines Aufrufs von JetStopServiceaufgetreten sind. |
JET_errInstanceUnavailable |
Es ist nicht möglich, den Vorgang abzuschließen, da für die instanz, die der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben. |
JET_errInvalidParameter |
Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert oder einen Wert, der in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll war. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete Instanz noch nicht initialisiert wurde. |
JET_errOutOfMemory |
Fehler beim Vorgang, weil kein Arbeitsspeicher zugeordnet werden konnte. |
JET_errOutOfSessions |
Die Anzahl der Sitzungen, die die Engine dem Client den Start erlaubt, ist begrenzt. Dieser Wert kann mithilfe von JetSetSystemParameter mit der JET_paramMaxSessions Konstante geändert werden. Die Standardanzahl von Sitzungen beträgt 16. Ausführliche Informationen zu JET_paramMaxSessionsfinden Sie unter Systemparameter. |
JET_errRestoreInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist. |
JET_errTermInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete Instanz heruntergefahren wird. |
Bei Erfolg wird das Sitzungshandle initialisiert und kann für Datenbankvorgänge verwendet werden.
Bei einem Fehler sind keine Sitzungen verfügbar, oder eine neue Sitzung konnte nicht initialisiert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Header |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
JET_SESID
JetBeginSession
JetSetSystemParameter
JetStopService
Systemparameter