IPOutlookApp::get_OutlookCompatible

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The get_OutlookCompatible method returns a value that indicates whether the mobile device is partnered with a desktop computer running Outlook, as opposed to running Schedule+.

Syntax

HRESULT get_OutlookCompatible(
   VARIANT_BOOL * pfCompat
);

Parameters

  • pfCompat
    [out] Reference to a Boolean flag. VARIANT_TRUE if the device is partnered with a desktop computer running Outlook, otherwise VARIANT_FALSE. For information about the VARIANT_BOOL type, see the union member of the PROPVARIANT structure.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    The method completed successfully.

Remarks

This method is useful because there are differences in behavior between Outlook and Schedule+. For example, a task with a start date of None must also have a due date of None if partnered with a desktop computer running Schedule+.

The VARIANT_BOOL data type (also known as VT_BOOL) uses the value -1 to represent TRUE and 0 to represent FALSE. It is defined in the wtypes.h header file in the following manner:

typedef short VARIANT_BOOL;

A common programming error occurs when, for readability purposes, you want to set a VARIANT_BOOL value to TRUE or FALSE. You can achieve the same effect by using the aliases VARIANT_TRUE and VARIANT_FALSE, which are also defined in the wtypes.h header file.

#define VARIANT_TRUE  ((VARIANT_BOOL)0xffff)
#define VARIANT_FALSE ((VARIANT_BOOL)0)

Schedule+ is not supported in platform versions later than Windows Mobile 2003 Second Edition. In this case, pfCompat always returns VARIANT_TRUE.

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IPOutlookApp
Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations