IExStoreDispEventInfo::EventConnection

[This is preliminary documentation and subject to change.]

The ADO Connection object for the current event.

[Visual Basic,VBScript]
Property EventConnection As Object
read-only
[C++]
HRESULT EventConnection (IDispatch** pConnection);
[IDL]
[propget] HRESULT EventConnection( 
   [out,retval] IDispatch** pConnection
   );

pConnection [C++,IDL]

Upon successful return, the passed address contains a valid IDispatch object reference on the ADO Connection object used to bind to the store.

Return Value

This method returns S_OK if the call succeeds.

Remarks

This method returns the IDispatch interface pointer for the ADO Connection object created in the context of the event. This method is similar to IExStoreEventInfo::GetEventSession except that OLE Automation compatible ADO objects and interfaces are returned 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 an OA compatible interface
  Dim iDispEvtInfo as IExStoreDispEventInfo
  Set iDispEvtInfo = pEventInfo
  
  ' Get the Connection used for the event
  Dim Conn as ADODB.Connection
  Set Conn = iDispEvtInfo.EventConnection
  ' ...
End Sub