적용 대상: 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 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다. |
JET_errInstanceUnavailable |
세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. Windows XP: 이 반환 값은 Windows XP에 도입되었습니다. |
JET_errNotInitialized |
세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다. |
JET_errRestoreInProgress |
세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다. |
JET_errSessionSharingViolation |
두 개 이상의 스레드에 대해 동시에 동일한 세션을 사용할 수 없습니다. Windows XP: 이 반환 값은 Windows XP에 도입되었습니다. |
JET_errTermInProgress |
세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다. |
이 함수가 성공하면 지정된 커서와 연결된 테이블이 있는 지정된 콜백 이유로 지정된 콜백이 등록 취소됩니다. 데이터베이스 상태는 변경되지 않습니다.
이 함수가 실패하면 지정된 콜백이 등록 취소되지 않습니다. 데이터베이스 상태는 변경되지 않습니다.
설명
지정된 비트 마스크는 콜백을 등록할 때 지정된 비트 마스크와 정확히 일치해야 합니다. 데이터베이스 엔진은 현재 이러한 알림의 하위 집합 제거를 지원하지 않으며 이 시도가 시도될 때 오류를 반환하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
클라이언트 |
Windows Vista 또는 Windows XP가 필요합니다. |
서버 |
Windows Server 2008 또는 Windows Server 2003이 필요합니다. |
머리글 |
Esent.h에서 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
참고 항목
JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService