Register Method

  • Article

Register 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 allows you to deny event registration requests or respond to event registration items when they are modified, moved, copied, or replicated.

Applies To

ICreateRegistration Interface

Type Library

EXOLEDB Type Library

DLL Implemented In

EXOLEDB.DLL

Syntax



[Visual Basic]Sub Register
(
    pEventInfo As IExStoreEventInfo,
    bstrURLItem As String,
    lFlags As LONG
) As LONG






[C++]HRESULT Register
(
    IExStoreEventInfo* pEventInfo,
    BSTR bstrURLItem,
    LONG lFlags,
    LONG* phr
);



Parameters




    

  • pEventInfo
    
A pointer to an IExStoreEventInfo interface that can be used to obtain further event information, such as the registration item.
    

    • 

  • bstrURLItem
    
A string containing the URL to the registration item seeking to be registered.
    

    • 

  • lFlags
    
Flags to indicate what is occurring to the registration item.
    

    


    
Decimal Value
C++ Enum Equivalent
Description

    
    


    
1
EVT_NEW_ITEM
The registration item is newly created (a new request).

    

    
4
EVT_REPLICATED_ITEM
The registration item is being replicated from another location.

    

    
256
EVT_MOVE
The registration item is being moved.

    

    
512
EVT_COPY
The item registration item is being copied.

    
    

    

    If no flag is set then the item is being resaved to the same location.
    

    • 

  • phr
    
Return value: S_OK if registration is allowed, S_FALSE if registration is denied.
    

    • 





Return Value




Returns S_OK if successful, or an error value otherwise.




Remarks




When an event registration item is saved, copied, moved, or replicated, Microsoft Exchange Server 2003 automatically queries your event sink for the ICreateRegistration Interface and, if available, calls this method.


This method provides a programmatic means to evaluate a new event registration request, as well as, when an event registration item is modified, moved, copied, or replicated. In this method you can access the registration item where the user, and the store item resides.




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.