RemoteGetEventItem Method

Topic Last Modified: 2006-06-13

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

Applies To

IExStoreEventInfo Interface

Type Library

EXOLEDB Type Library

DLL Implemented In

EXOLEDB.DLL

Syntax

Sub RemoteGetEventItem(    riid As REFIID,
        pdwBindStatus As Long,
        ppunkEventItem As Object)
HRESULT RemoteGetEventItem
(
        REFIID riid,
        DWORD* pdwBindStatus,
        IUnknown** ppunkEventItem
);

Parameters

• 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 remote item that triggered the event.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

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

This method is functionally equivalent to the EventRecord Property method on the IExStoreDispEventInfo 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.

See the IExStoreDispEventInfo Interface for related methods for Visual Basic and scripts.