JET_CALLBACK 콜백 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JET_CALLBACK 콜백 함수

JET_CALLBACK 함수는 데이터베이스 엔진이 온라인 조각 모음 및 커서 상태 알림과 관련된 이벤트를 애플리케이션에 알리는 데 사용하는 다목적 콜백 함수입니다.

이러한 설정은 cbtyp 매개 변수에서 사용하도록 선택된 JET_CBTYP 옵션에 따라 다르므로 이 함수의 매개 변수에 사용할 특정 설정은 JET_CBTYP 참조하세요.

    JET_ERR JET_API* JET_CALLBACK(
      [in]                 JET_SESID sesid,
      [in]                 JET_DBID dbid,
      [in]                 JET_TABLEID tableid,
      [in]                 JET_CBTYP cbtyp,
      [in, out]            void* pvArg1,
      [in, out]            void* pvArg2,
      [in]                 void* pvContext,
      [in]                 JET_API_PTR ulUnused
    );

매개 변수

sesid

콜백이 이루어지는 세션입니다.

dbid

콜백이 만들어지는 데이터베이스입니다.

tableid

콜백이 만들어지는 커서입니다.

cbtyp

콜백이 수행되는 작업의 지점입니다. 각 사례에서 값 목록과 다음 매개 변수의 의미는 JET_CBTYP 참조하세요.

pvArg1

콜백을 사용하여 애플리케이션과 통신하는 데 사용되는 매개 변수입니다. 데이터베이스 엔진에서 지원하는 각 콜백에 대해 이 매개 변수의 사용에 대한 자세한 내용은 JET_CBTYP 참조하세요.

pvArg2

pvContext

ulUnused

반환 값

함수는 확장 가능한 스토리지 엔진 오류 코드 중 하나를 반환합니다. 이러한 코드를 HRESULT로 반환하는 방법에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류를 참조하세요. 성공하면 콜백을 실행한 작업이 정상적으로 진행될 수 있습니다. 경우에 따라 콜백은 해당 작업에 영향을 주는 경고를 반환할 수 있습니다. 작업에서 이러한 경고를 사용하는 방법에 대한 자세한 내용은 JET_CBTYP 참조하세요.

실패 시 콜백을 실행한 작업이 정상적으로 진행되거나 실패할 수 있습니다. 작업에 의한 오류 코드 사용에 대한 자세한 내용은 JET_CBTYP 참조하세요.

설명

콜백이 애플리케이션에 커서를 전달하는 경우 재귀 및 기타 추악함을 방지하기 위해 이 커서가 의도적으로 더 작은 기능 집합으로 제한된다는 것을 알아야 합니다. 다음 작업이 허용됩니다.

콜백을 디자인할 때 이러한 제한 사항이 있더라도 콜백이 실패할 수 있다는 점을 고려합니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에서 선언되었습니다.

참고 항목

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP

JET_CALLBACK 콜백 함수