JetUnregisterCallback-Funktion

Gilt für: Windows | Windows Server

JetUnregisterCallback-Funktion

Mit der JetUnregisterCallback-Funktion kann die Anwendung die Datenbank-Engine so konfigurieren, dass keine Benachrichtigungen mehr an die Anwendung gesendet werden, 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, dass die Anwendung keine Benachrichtigungen mehr empfangen möchte.

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

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 Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf der -Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopService beendet wurden.

JET_errInstanceUnavailable

Der Vorgang kann nicht abgeschlossen werden, 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.

Windows XP: Dieser Rückgabewert wird in xp Windows eingeführt.

JET_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die -Instanz, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde.

JET_errRestoreInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die -Instanz durchgeführt wird, die der Sitzung zugeordnet ist.

JET_errSessionSharingViolation

Dieselbe Sitzung kann nicht gleichzeitig für mehrere Threads verwendet werden.

Windows XP: Dieser Rückgabewert wird in xp Windows eingeführt.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die -Instanz, die der Sitzung zugeordnet ist, heruntergefahren wird.

Wenn diese Funktion erfolgreich ist, wird die Registrierung des angegebenen Rückrufs aus den angegebenen Rückrufgründen bei der Tabelle aufgehoben, die dem angegebenen Cursor zugeordnet ist. Es erfolgt keine Änderung des Datenbankstatus.

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

Bemerkungen

Die angegebene Bitmaske sollte genau mit der Bitmaske übereinstimmen, die beim Registrieren des Rückrufs angegeben wird. Die Datenbank-Engine unterstützt derzeit nicht das Entfernen einer Teilmenge dieser Benachrichtigungen und gibt bei diesem Versuch keinen Fehler zurück.

Requirements (Anforderungen)

Anforderung Wert

Client

Erfordert Windows Vista oder Windows XP.

Server

Erfordert Windows Server 2008 oder Windows Server 2003.

Header

Wird in Esent.h deklariert.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService