IExStoreDispEventInfo::EventRecord

[This is preliminary documentation and subject to change.]

The ADO Record object bound to the item that caused the event.

[Visual Basic,VBscript]
Property EventRecord As Object
read-only
[C++]
HRESULT EventRecord(IDispatch** ppRecord);
[IDL]
[propget] HRESULT EventRecord( IDispatch** ppRecord);

pVal [C++,IDL]

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

Return Value

This method returns S_OK if the call succeeds.

Remarks

This method returns the IDispatch interface on the ADO Record object created in the context of the event. This method is similar to the IExStoreEventInfo::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 asynchronous events, the object is implicitly created using an IBindResource::Bind call. The object is created within the security context of the default user. Access is limited to the event item.

Example

Private Sub IExStoreAsyncEvents_OnSave( _
  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