HrCreateApptRebaser

Initializes an IOlkApptRebaser object for use in rebasing appointments in Microsoft Office Outlook calendars.

Quick Info

  HRESULT HrCreateApptRebaser( 
    ULONG ulFlags,
    IMAPISession *pSession,
    IMsgStore *pCalendarMsgStore,
    IMAPIFolder *pCalendarFolder,
    LPCWSTR pwszUpdatePrefix,
    const FILETIME *pftInstallDateUTC,
    LONG lExpansionDepth,
    const TZDEFINITION *pTZTo,
    const TZDEFINITION *pTZMissing,
    MAPIERROR **ppError,
    IOlkApptRebaser **ppApptRebase);

Parameters

ulFlags

[in] Required. Bitmask of flags used to control how rebasing is performed. The following flags can be set:

REBASE_FLAG_UPDATE_ORGANIZED_MEETINGS

Appointment items in which the user is the meeting organizer are rebased. Note that by default, this causes Outlook to send meeting updates to all attendees of any meeting being rebased. You can combine this flag with either REBASE_FLAG_FORCE_NO_EX_UPDATES or REBASE_FLAG_FORCE_NO_UPDATES to change how meeting updates are handled.

REBASE_FLAG_UPDATE_UNMARKED

Update appointment items that have not been marked with a time zone. If this flag is specified, the pTZMissing value is used as the time zone that an item is created in for all items that do not have time zone data.

REBASE_FLAG_UPDATE_ONLYRECURRING

Update only recurring appointment items.

REBASE_FLAG_NO_UI

Do not show any user interface (UI), including logon dialog boxes generally displayed when opening a message store.

REBASE_FLAG_UPDATE_MINIMIZEAPPTS

Do not rebase appointment items that occur in the past.

REBASE_FLAG_FORCE_REBASE

Do not check the organizer for rebasing decisions, but rebase appointment items in which the user is an attendee.

REBASE_FLAG_FORCE_NO_EX_UPDATES

Only send updates if the user is the organizer and recipient is not connected to an Exchange Server.

REBASE_FLAG_FORCE_NO_UPDATES

Never send updates.

REBASE_FLAG_ONLY_CREATED_PRE_PATCH

Only rebase single-instance appointment items created before the patch was applied.

REBASE_FLAG_REPORTING_MODE

Do not actually rebase, just report appointment items that would be rebased.

REBASE_FLAG_SEND_RESOURCE_UPDATES

Send meeting updates to resources.

pSession

[in] Required. Pointer to a MAPI session interface.

pCalendarMsgStore

[in] Required. Pointer to a message store containing appointment items to be rebased.

pCalendarFolder

[in] Required. Pointer to a calendar folder containing appointment items to be rebased.

pwszUpdatePrefix

[in] Optional. Pointer to a string containing the prefix to be prepended on meeting requests. May be NULL.

pftInstallDateUTC

[in] Optional. Timezone patch install date. Only used if the REBASE_FLAG_ONLY_CREATED_PRE_PATCH flag is set.

IExpansionDepth

[in] Optional. Expansion depth when expanding distribution lists to exclude recipients connected to Exchange Server. Only used if the REBASE_FLAG_FORCE_NO_EX_UPDATES flag is set.

pTZTo

[in] Required. Pointer to a TZDEFINITION structure describing the time zone to be rebased to. TZDEFINITION is defined in tzmovelib.h.

pTZMissing

[in] Required. Pointer to a TZDEFINITION structure describing the time zone to be assumed if time zone information is not stamped on an item. Must not be NULL, but only used if the REBASE_FLAG_UPDATE_UNMARKED flag is set.

ppError

[out] Pointer to a pointer to a MAPIERROR structure containing version, component, and context information for the error. Can be NULL if no extended error information is desired. Free with MAPIFreeBuffer.

ppApptRebase

[out] Pointer to a pointer to the returned IOlkApptRebaser interface.

Return Values

S_OK

The function call is successful.

Remarks

When using GetProcAddress to look for the address of this function in tzmovelib.dll, specify HrCreateApptRebaser@44 as the procedure name. Not all of the flags are valid in combination with each other.

For more information about the various options, see the section "Glossary of command-line options for the Outlook Time Zone Data Update tool" in KB 931667: How to address the daylight saving time changes in 2007 by using the Time Zone Data Update Tool for Microsoft Office Outlook.

See Also

About Rebasing Calendars Programmatically for Daylight Saving Time