• Article

EventRecord Property

Topic Last Modified: 2006-06-13

The Microsoft® ActiveX® Data Objects (ADO) Record object bound to the item that caused the event. This property is read-only.

Applies To

IExStoreDispEventInfo Interface

Type Library

EXOLEDB Type Library

DLL Implemented In

EXOLEDB.DLL

Syntax

Property EventRecord As Object
HRESULT get_EventRecord(IDispatch** ppRecord);

Parameters

  • ppRecord
    On successful return, the passed address contains the IDispatch interface of the ADO Record object bound to the store item that triggered the event.

Remarks

This property returns the IDispatch interface on the ADO Record object created in the context of the event. This method is similar to the GetEventItem Method, except that OLE Automation-compatible ADO objects and interfaces are used rather than OLE DB objects and interfaces.

For synchronous events, the event session executes within a local transaction.

For an asynchronous event, the EventRecord Property does not return the event item. An alternative for retrieving the event item is to open an ADO Record object using the item's URL, which is passed in via the bstrURLItem paramater of the OnSave Method.

Example


Private Sub IExStoreSyncEvents_OnSyncSave( _
  ByVal pEventInfo as ExevtsnkLib.IExStoreEventInfo, _
  ByVal bstrURLSource as String, _
  ByVal lFlags as Long _
)

  ' Get OA compatible interface
  Dim iDispEvtInfo as IExStoreDispEventInfo
  Set iDispEvtInfo = pEventInfo

  ' Get the record that triggered the event
  Dim Rec as ADODB.Record
  Set Rec = iDispEvtInfo.EventRecord
  ' ...
End Sub