Partager via

  • Article

IExStoreDispEventInfo Interface

Topic Last Modified: 2006-06-13

This is a support interface that can be obtained within every OLE DB store event sink. It is used to retrieve event information and control the event transaction.

Type Library

EXOLEDB Type Library

DLL Implemented In

EXOLEDB.DLL

Member Summary

The following table lists the properties of the IExStoreDispEventInfo interface.

Name Description

Data

The Data property handles in-memory data that is stored between the begin phase and the commit/abort phase of synchronous events.

EventConnection

The Microsoft® ActiveX® Data Objects (ADO) Connection object for the current event. This property is read-only.

EventRecord

The ADO Record object bound to the item that caused the event. This property is read-only.

SourceURL

The original source URL during an OnSyncSave event that was caused by a move. This property is read-only.

StoreGuid

This property returns the globally unique identifier (GUID) of the message database (MDB) store in which the event fired. This property is read-only.

UserGuid

This property returns the GUID of the user that caused the event to fire. This property is read-only.

UserSid

This property returns the security identifier (SID) of the user that caused the event to fire. This property is read-only.

The following table lists the methods of the IExStoreDispEventInfo interface.

Name Description

AbortChange

This method aborts the transaction in which synchronous events are currently executing.

Remarks

The IExStoreDispEventInfo interface is the OLE Automation compatible version of the IExStoreEventInfo Interface. Languages such as Microsoft Visual Basic® can access the ADO equivalents of the OLE DB object references using the various IExStoreDispEventInfo methods.

The IExStoreDispEventInfo interface is exposed on the same object as the passed IExStoreEventInfo object reference. It can be obtained by calling QueryInterface on the IExStoreEventInfo object reference passed to the sink.

Example

[Visual Basic]

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

'In Visual Basic this next line does the QueryInterface
 Set iDispEvtInfo = pEventInfo

  ' Get ADO record for save item
  Dim Rec as ADODB.Record
  Set Rec = iDispEvtInfo.EventRecord
  ' ...
End Sub