Export (0) Print
Expand All

Register Method

Exchange Server 2003

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

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
(
    IExStoreEventInfopEventInfo,
    BSTR bstrURLItem,
    LONG lFlags,
    LONGphr
);

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.

Show:
© 2014 Microsoft