WillMove 및 MoveComplete 이벤트(ADO)

보류 중인 작업이 Recordset현재 위치를 변경하기 전에 WillMove 이벤트가 호출됩니다. MoveComplete 이벤트는 Recordset의 현재 위치가 변경된 후 호출됩니다.

통사론

  
WillMove adReason, adStatus, pRecordset  
MoveComplete adReason, pError, adStatus, pRecordset  

매개 변수

adReason
이 이벤트의 이유를 지정하는 EventReasonEnum 값입니다. 해당 값은 adRsnMoveFirst , adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove또는 adRsnRequery 수 있습니다.

pError
Error 개체입니다. adStatus 값이 adStatusErrorsOccurred 경우 발생한 오류를 설명합니다. 그렇지 않으면 매개 변수가 설정되지 않습니다.

adStatus
EventStatusEnum 상태 값입니다.

WillMove 호출되면 이 매개 변수는 이벤트를 발생시킨 작업이 성공한 경우 adStatusOK 설정됩니다. 이 이벤트가 보류 중인 작업의 취소를 요청할 수 없는 경우 adStatusCantDeny 설정됩니다.

MoveComplete 호출되면 이 매개 변수는 이벤트를 발생시킨 작업이 성공한 경우 adStatusOK , 작업이 실패한 경우 adStatusErrorsOccurred 설정됩니다.

WillMove 반환하기 전에 이 매개 변수를 adStatusCancel 설정하여 보류 중인 작업의 취소를 요청하거나 이 매개 변수를 adStatusUnwantedEvent 설정하여 후속 알림을 방지합니다.

MoveComplete 반환하기 전에 이 매개 변수를 adStatusUnwantedEvent 설정하여 후속 알림을 방지합니다.

pRecordset
Recordset 개체입니다. 이 이벤트가 발생한 Recordset.

발언

WillMove 또는 MoveComplete 이벤트는 레코드 집합 작업으로 인해 발생할 수 있습니다. 열기, 이동, MoveFi, MoveLast, MoveNext, MovePrevious, AddNew및 Requery. 이러한 이벤트는 필터, 인덱스, 책갈피, AbsolutePage및 AbsolutePosition때문에 발생할 수 있습니다. 이러한 이벤트는 자식 Recordset 연결된 Recordset 이벤트가 있고 부모 Recordset 이동하는 경우에도 발생합니다.

adReason 매개 변수를 포함하는 이벤트에 대한 이벤트 알림을 완전히 중지하려면 가능한 각 adReason 값에 대해 adStatusUnwantedEvent adStatus 매개 변수를 설정해야 합니다.

참고 항목

ADO 이벤트 모델 예제(VC++)
ADO 이벤트 처리기 요약
ADO(Recordset 개체)