About the Free/Busy API

The Free/Busy API allows mail providers to provide free/busy status information for specified user accounts within a specified time range. The free/busy status of a block of time on a user's calendar is one of the following: out-of-office, busy, tentative, or free.

Create a free/busy provider

To provide free/busy information to mail users, a mail provider creates a free/busy provider and registers it with Outlook. The free/busy provider must implement the following interfaces. Note that a number of members in these interfaces are not supported and must return the specified return values. In particular, the Free/Busy API does not support write access to free/busy information and delegate access to accounts.

• IFreeBusySupport —This interface supports specification of interfaces that access free/busy data for specified users. It uses FBUser to identify a user.

• IFreeBusyData —This interface gets and sets a time range for a given user and returns an interface for enumerating free/busy blocks of data within this time range. It uses relative time to get and set this time range. For more information, see Use relative time to access free/busy data.

• IEnumFBBlock —This interface supports accessing and enumerating free/busy blocks of data for a user within a time range.

  Note

  An enumeration contains free/busy blocks that indicate the free/busy status of periods of time on a user's calendar, within a time range (specified by IFreeBusyData::EnumBlocks). Items on a calendar, such as appointments and meeting requests, form blocks in the enumeration. Items that are adjacent to one another on the calendar and have the same free/busy status are combined to form one single block. A free period of time on a calendar also forms a block. Therefore, no two consecutive blocks in an enumeration would have the same free/busy status. These blocks do not overlap in time. When there are overlapping items on a calendar, Outlook merges these items to form non-overlapping free/busy blocks in the enumeration based on this order of precedence: out-of-office, busy, tentative.

To register the free/busy provider with Outlook, the mail provider should do the following:

1. Register the free/busy provider with COM, providing a CLSID that allows access to the provider's implementation of IFreeBusySupport.

2. Let Outlook know that the free/busy provider exists by setting the following key (where <xx.x> represents the version of Outlook) in the system registry:

   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<xx.x>\Outlook\SchedulingInformation\FreeBusySupport

   For example, if the transport provider is SMTP, to register the provider with Microsoft Outlook 2010, set the following key to the data in the following table:

   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Outlook\SchedulingInformation\FreeBusySupport

   Name	Type	Value
   SMTP	REG_SZ	{CLSID for respective implementation of IFreeBusySupport}

   In this scenario, Outlook co-creates the COM class and uses it to retrieve free/busy information for any SMTP mail users.

To support an address book and transport provider that use an address entry type other than SMTP, change the Name accordingly.

API components

The Free/Busy API includes the following components:

Definitions

• Constants (Free/busy API)

Data types

• FBBlock_1
• FBStatus
• FBUser

Interfaces

• IEnumFBBlock
• IFreeBusyData
• IFreeBusySupport