JetDupSession-Funktion

Gilt für: Windows | Windows Server

JetDupSession-Funktion

Die JetDupSession-Funktion startet eine Sitzung und initialisiert und gibt ein ESE-Sitzungshandle (JET_SESID) zurück. Sitzungen steuern den gesamten Zugriff auf die Datenbank und werden verwendet, um den Umfang von Transaktionen zu steuern. Die Sitzung kann verwendet werden, um Transaktionen zu starten, zu commiten oder abzubrechen. 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 auf alle Arten als JetBeginSession, die auf der instance 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 möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

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 dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs von JetStopService beendet wurden.
JET_errInstanceUnavailable	Es ist nicht möglich, den Vorgang abzuschließen, da beim instance, der 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 höheren 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 instance noch nicht initialisiert wurde.
JET_errOutOfMemory	Der Vorgang ist fehlgeschlagen, weil arbeitsspeicher nicht zugewiesen werden konnte.
JET_errOutOfSessions	Die Anzahl der Sitzungen, die die Engine dem Start des Clients ermöglicht, ist begrenzt. Dieser Wert kann mithilfe von JetSetSystemParameter mit der konstanten JET_paramMaxSessions geändert werden. Die Standardanzahl von Sitzungen ist 16. Ausführliche Informationen zu JET_paramMaxSessions finden Sie unter Systemparameter.
JET_errRestoreInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da auf dem der Sitzung zugeordneten instance ein Wiederherstellungsvorgang ausgeführt wird.
JET_errTermInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance 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.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

JET_SESID
JetBeginSession
JetSetSystemParameter
JetStopService
Systemparameter