JetUnregisterCallback 関数

[アーティクル]
06/13/2023

適用対象: Windows |Windows Server

JetUnregisterCallback 関数

JetUnregisterCallback 関数を使用すると、以前に JetRegisterCallback で要求されたとおりに、アプリケーションへの通知の発行を停止するようにデータベースエンジンを構成できます。

Windows XP:JetUnregisterCallback は Windows XP で導入されました。

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

パラメーター

sesid

この呼び出しに使用するセッション。

tableid

この呼び出しに使用するカーソル。

cbtyp

アプリケーションが通知を受信することを望まないコールバックの理由で構成されるビットマスク。

このビットマスクを作成するには、 JET_CBTYP 列挙の有効なコールバック理由を単純にまたはまとめて作成します。

hCallbackId

JetRegisterCallback によって返された登録済みコールバックのハンドル。

戻り値

この関数は、次のいずれかの戻りコードを使用して、JET_ERR データ型を返します。考えられる ESE エラーの詳細については、「拡張ストレージエンジンエラーとエラー処理パラメーター」を参照してください。

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errClientRequestToStopJetService	JetStopService の呼び出しの結果、セッションに関連付けられているインスタンスのすべてのアクティビティが停止したため、操作を完了できません。
JET_errInstanceUnavailable	セッションに関連付けられているインスタンスで、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要がある致命的なエラーが発生したため、操作を完了できません。 Windows XP: この戻り値は、Windows XP で導入されています。
JET_errNotInitialized	セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。
JET_errRestoreInProgress	セッションに関連付けられているインスタンスで復元操作が進行中のため、操作を完了できません。
JET_errSessionSharingViolation	同じセッションを複数のスレッドに同時に使用することはできません。 Windows XP: この戻り値は、Windows XP で導入されています。
JET_errTermInProgress	セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。

この関数が成功した場合、指定されたカーソルに関連付けられているテーブルを使用して、指定されたコールバックの理由により、指定されたコールバックの登録が解除されます。データベースの状態に対する変更は行われません。

この関数が失敗した場合、指定されたコールバックは登録解除されません。データベースの状態に対する変更は行われません。

解説

指定されたビットマスクは、コールバックの登録時に指定されたビットマスクと完全に一致する必要があります。データベースエンジンは現在、これらの通知のサブセットの削除をサポートしていないため、この操作を試行してもエラーは返されません。

必要条件

要件	値
Client	Windows Vista または Windows XP が必要です。
[サーバー]	Windows Server 2008 または Windows Server 2003 が必要です。
Header	Esent.h で宣言されています。
Library	ESENT.lib を使用します。
[DLL]	ESENT.dllが必要です。

参照

JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService

次の方法で共有

JetUnregisterCallback 関数