WillChangeRecord 및 RecordChangeComplete 이벤트(ADO)

WillChangeRecord 이벤트는 레코드 집합에서 하나 이상의 레코드(행)가 변경되기 전에 호출됩니다. RecordChangeComplete 이벤트는 하나 이상의 레코드가 변경된 후에 호출됩니다.

구문

  
WillChangeRecord adReason, cRecords, adStatus, pRecordset  
RecordChangeCompleteadReason, cRecords, pError, adStatus, pRecordset  

매개 변수

adReason
이 이벤트의 이유를 지정하는 EventReasonEnum 값입니다. 값은 adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete 또는 adRsnFirstChange일 수 있습니다.

cRecords
변경되는(영향을 받는) 레코드 수를 나타내는 Long 값입니다.

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

adStatus
EventStatusEnum 상태 값입니다.

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

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

WillChangeRecord가 반환되기 전에 이 매개 변수를 adStatusCancel로 설정하여 이 이벤트를 발생시킨 작업의 취소를 요청하거나 이 매개 변수를 adStatusUnwantedEvent로 설정하여 후속 알림을 방지합니다.

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

pRecordset
Recordset 개체입니다. 이 이벤트가 발생한 레코드 집합입니다.

설명

WillChangeRecord 또는 RecordChangeComplete 이벤트는 Update, Delete, CancelUpdate, AddNew, UpdateBatch, CancelBatch와 같은 Recordset 작업으로 인해 행에서 첫 번째로 변경된 필드에 대해 발생할 수 있습니다. RecordsetCursorType 값은 이벤트가 발생하는 작업을 결정합니다.

WillChangeRecord 이벤트 중에 RecordsetFilter 속성은 adFilterAffectedRecords로 설정됩니다. 이벤트를 처리하는 동안에는 이 속성을 변경할 수 없습니다.

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

참고 항목

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