IExStoreEventInfo::GetEventItem

[This is preliminary documentation and subject to change.]

This method returns the requested interface on the OLE DB Row object that triggered the event.

[Visual Basic, VBScript]
not applicable.
[C++]
HRESULT GetEventItem (
   REFIID riid, 
   DWORD *pdwBindStatus, 
   IUnknown **ppunkEventItem
   ); 
[IDL]
HRESULT GetEventItem (
   [in]REFIID riid, 
   [out]DWORD *pdwBindStatus, 
   [out]IUnknown **ppunkEventItem
   );

riid

The interface identifier (IID) of the interface on the item to return in the third argument.

pdwBindStatus

The returned status code.

ppunkEventItem

On successful return, the address passed contains the IUnknown object reference on the item that triggered the event.

Return Value

This method returns S_OK if successful.

Remarks

For synchronous events, this item is created within a transaction. For asynchronous events the object is created through the IBindResource::Bind call. The object is created within the security context of the default user. Access is limited to the event item.

This method is functionally equivalent to the EventRecord method on the IExStoreDispEventInfo dual interface. When working with Microsoft® Visual Basic® and scripting languages, you need to make sure to retrieve this OLE Automation compatible interface from the passed object.