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