HrCreateApptRebaser
HrCreateApptRebaser |
Initializes an IOlkApptRebaser object for use in rebasing appointments in Microsoft Office Outlook calendars.
Quick Info
Header file: | tzmovelib.h |
Implemented by: | tzmovelib.dll |
Called by: | MAPI client applications |
Pointer type: | LPHRCREATEAPPTREBASER |
DLL entry point: | HrCreateApptRebaser@44 |
|
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