JetDupSession-Funktion

  • Artikel

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