Событие EndOfRecordset (ADO)

Событие EndOfRecordset вызывается при попытке перейти к строке после конца набора записей.

Синтаксис

  
EndOfRecordset fMoreData, adStatus, pRecordset  

Параметры

fMoreData
Значение VARIANT_BOOL , если задано значение VARIANT_TRUE, указывает на то, что в набор записей было добавлено больше строк.

adStatus
Значение состояния EventStatusEnum .

При вызове EndOfRecordset этому параметру присваивается значение adStatusOK , если операция, вызвавшей событие, была успешной. Для этого события задано значение adStatusCantDeny , если это событие не может запросить отмену операции, вызвавшей это событие.

Перед возвратом EndOfRecordset задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления.

pRecordset
Объект Recordset . Набор записей, для которого произошло это событие.

Комментарии

Если операция MoveNext завершается сбоем, может возникнуть событие EndOfRecordset.

Этот обработчик событий вызывается при попытке перемещения за конец объекта Recordset , возможно, в результате вызова Метода MoveNext. Однако в этом случае можно получить дополнительные записи из базы данных и добавить их в конец набора записей. В этом случае задайте для параметра fMoreData значение VARIANT_TRUE и вернитесь из EndOfRecordset. Затем снова вызовите MoveNext , чтобы получить доступ к вновь извлеченным записям.

См. также:

Пример модели событий ADO (Visual C ++)
Общие сведения об обработчике событий ADO