ITask::put_ReminderSet

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The ReminderSet property gets and sets a value that indicates whether the user wants a reminder to complete the Task. The default is the current setting for the Tasks application.

To set the value of the ReminderSet property, call the property method described here.

To get the value of the ReminderSet property, see the ITask::get_ReminderSet property method.

Syntax

HRESULT put_ReminderSet(
   VARIANT_BOOL fReminderSet
);

Parameters

• fReminderSet
  [in] Reference to the Boolean flag. VARIANT_TRUE when the user wants a reminder to complete the Task. 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

When the user marks a Task as Complete and then saves it, the reminder flag is automatically cleared internally, even though the Task's ReminderSet property might still be VARIANT_TRUE when the user saves the Task. When the user reacquires the completed Task item from the Task Collection, the value of its ReminderSet property will be VARIANT_FALSE.

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)

Requirements

See Also

Reference

ITask
Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations