JetUnregisterCallback-Funktion

Artikel
06/12/2023

Gilt für: Windows | Windows Server

JetUnregisterCallback-Funktion

Die JetUnregisterCallback-Funktion ermöglicht es der Anwendung, die Datenbank-Engine so zu konfigurieren, dass die Ausgabe von Benachrichtigungen an die Anwendung beendet wird, wie zuvor über JetRegisterCallback angefordert.

Windows XP:JetUnregisterCallback wird in Windows XP eingeführt.

    JET_ERR JET_API JetUnregisterCallback(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_CBTYP cbtyp,
      __in          JET_HANDLE hCallbackId
    );

Parameter

sesid

Die Sitzung, die für diesen Aufruf verwendet werden soll.

tableid

Der Cursor, der für diesen Aufruf verwendet werden soll.

cbtyp

Eine Bitmaske, die aus den Rückrufgründen besteht, aus denen die Anwendung keine Benachrichtigungen mehr empfangen möchte.

Um diese Bitmaske zu erstellen, müssen Sie einfach oder zusammen gültige Rückrufgründe aus der JET_CBTYP-Enumeration verwenden.

hCallbackId

Das Handle des registrierten Rückrufs, der von JetRegisterCallback zurückgegeben wurde.

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	Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs von JetStopService beendet wurde.
JET_errInstanceUnavailable	Der Vorgang kann nicht abgeschlossen werden, da bei der instance, 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. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.
JET_errNotInitialized	Der Vorgang kann nicht abgeschlossen werden, da die instance, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde.
JET_errRestoreInProgress	Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die instance ausgeführt wird, die der Sitzung zugeordnet ist.
JET_errSessionSharingViolation	Dieselbe Sitzung kann nicht für mehrere Threads gleichzeitig verwendet werden. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.
JET_errTermInProgress	Der Vorgang kann nicht abgeschlossen werden, da die instance, die der Sitzung zugeordnet ist, heruntergefahren wird.

Wenn diese Funktion erfolgreich ist, wird der angegebene Rückruf für die angegebenen Rückrufgründe mit der Tabelle, die dem angegebenen Cursor zugeordnet ist, nicht registriert. Es wird keine Änderung des Datenbankstatus vorgenommen.

Wenn diese Funktion fehlschlägt, wird die Registrierung des angegebenen Rückrufs nicht aufgehoben. Es wird keine Änderung des Datenbankstatus vorgenommen.

Bemerkungen

Die angegebene Bitmaske sollte genau mit der Bitmaske übereinstimmen, die beim Registrieren des Rückrufs angegeben wird. Das Datenbankmodul unterstützt derzeit nicht das Entfernen einer Teilmenge dieser Benachrichtigungen und gibt keinen Fehler zurück, wenn dies versucht wird.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService

JetUnregisterCallback-Funktion