GetEventItem Method

  • Article

GetEventItem Method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

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

Applies To

IExStoreEventInfo Interface

Type Library

EXOLEDB Type Library

DLL Implemented In

EXOLEDB.DLL

Syntax



[Visual Basic]Sub GetEventItem
(
    ByVal riid As REFIID,
    ByVal pdwBindStatus As Long,
    ByVal ppunkEventItem As Object
)






[C++]HRESULT GetEventItem
(
    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 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.




Send us your feedback about the Microsoft Exchange Server 2003 SDK.


Build: June 2007 (2007.618.1)


© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.