FilterCreate()

Creates a new filter.

Token ID

AFTKN_FILTER_CREATE or 722

Syntax

DWORD FilterCreate(ENUM FilterType; 
                    BOOLEAN DefaultFilter)

Parameters

FilterType As ENUM

Specifies the filter type as follows:

1

Calendar

150

Empty

6

Inbox

7

Outbox

Calendar!, In Box!, and Out Box!

Automatically applies defined filter criteria. For example, since Calendar! only displays appointments, notes, and tasks, you do not have to filter mail items (see FilterSetItemType()). Empty! requires you to set all filter criteria, including type, source, and attributes as needed.

DefaultFilter As BOOLEAN

Return Values

DWORD

Filter handle (a number greater than zero, or zero if an error occurs).

Remarks

IMPORTANT: Delete the filter handle when it is no longer needed, or the system resources will be lost. See FilterDelete().