AddressEntryFilter Object

The AddressEntryFilter object specifies criteria for restricting a search on an AddressEntries8D27ZI collection.

Quick Info

Specified in header file:

MDISP.ODL

First available in version:

OLE Messaging Library 1.1

Parent objects:

AddressEntries8D27ZI collection

Child objects:

Fields0EU12H collection

Default property:

Name12HA592

 

Properties

 
Property name

Available in version

 
Type

 
Access

Address1082.H

1.1

String

Read/write

Application5GI0QO

1.1

String

Read-only

Class1CT5_O0

1.1

Long

Read-only

Fields9OO.7Z

1.1

Field object or Fields collection object

Read-only

Name12HA592

1.1

String

Read/write

NotE15ODX

1.1

Boolean

Read/write

Or2M0D076

1.1

Boolean

Read/write

Parent13HN1VR

1.1

AddressEntries collection object

Read-only

Session23X3PG

1.1

Session object

Read-only

 

Methods

 
Method name

Available in version

 
Parameters

IsSameAs1SPJGP4

1.1

object as Object

 

Remarks

An AddressEntryFilter object with no criteria is created by default for every AddressEntries8D27ZI collection. This means that initially the filter s properties are unset and its child Fields0EU12H collection is empty. You specify the filter by setting values for its properties, and by adding fields to its Fields collection and setting a value for each added field.

The filter is invoked when the AddressEntries collection is traversed with the Get methods. Each field participates in a MAPI search restriction comparing the field s ValueRDXHN1 property against the value of the AddressEntry property specified by the field s ID1WDZE73 property.

For fields of data type other than String, the MAPI search restriction type is RES_PROPERTY with relational operator RELOP_EQ. For fields of data type String, the restriction type is RES_CONTENT with fuzzy level options FL_SUBSTRING, FL_IGNORECASE, and FL_LOOSE.

The results of the individual restrictions are normally ANDed together to form the final filter value. You can change this by setting the Or2M0D076 property, which causes all the results to be ORed instead of ANDed. You can also set the NotE15ODX property to specify that the result of each individual restriction is to be negated before being ANDed or ORed into the final filter value.

The AddressEntryFilter object is persistent within its parent AddressEntries collection. It is not deleted even when it is released, and it remains attached to the AddressEntries collection until the collection s FilterJE.8C8 property is set to Nothing or the collection is itself released.