IExchangeClientFreeBusyInformation::GetFreeBusyData (Windows CE 5.0)

Send Feedback

This method provides the free/busy data associated with the free/busy data entry.

HRESULT GetFreeBusyData(  WCHAR* wszDataBuffer,  UINT cchDataBuffer);

Parameters

• wszDataBuffer
  [out] Pointer to a caller-allocated buffer that this method uses to store the free/busy data.
• cchDataBuffer
  [in] The size of the buffer represented by the pointer in the wszDataBuffer parameter.

Return Values

The following table shows possible return values:

Remarks

The free/busy data returned in the wszDataBuffer parameter is a string that looks similar to this:

0000111100002222

Each numeral represents the free/busy status for a particular interval of time. The numbers used in the return data are as follows:

• 0 - Free
• 1 - Busy
• 2 - Tentative
• 3 - Out of office
• 4 - Data not available

To set the time when the returned free/busy data starts, use the FreeBusyCriteria instance you pass to IExchangeClient::RequestFreeBusyData.

To control the amount and granularity of data returned, use the FBSSearchLength and FBSInterval registry settings documented in Exchange Client Registry Settings.

For more information about free/busy information returned by Outlook Web Access (OWA) servers, search for article 813268 at this Microsoft web site.

In some organizations, not all OWA servers contain free/busy information. For example, in organizations that use server clustering only the externally accessible servers might contain free/busy data; internal servers might not.

To retrieve free/busy data using a search initiated with this method you must use a server that contains free/busy data.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: IExchangeClient.h, IExchangeClient.idl.
Link Library: OWAExchangeClient.lib.

See Also

IExchangeClientFreeBusyInformation

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.