PreviousNext

DS_C_SEARCH_CRITERION

An instance of OM class DS_C_SEARCH_CRITERION is a component of a DS_C_SEARCH_GUIDE OM object.

An instance of this OM class has the OM attributes of its superclass, OM_C_OBJECT, in addition to the OM attributes listed in the following table.


OM Attributes of DS_C_SEARCH_CRITERION


OM Attribute

Value Syntax
Value Length Value Number Value Initially
DS_
ATTRIBUTE_
TYPE
String (OM_S_
OBJECT_
IDENTIFIER_
STRING
- 0 or 1 -
DS_CRITERIA Object(DS_C_
SEARCH_
CRITERION
- 0 or more -
DS_FILTER_
ITEM_TYPE
Enum(DS_Filter_
Item_Type
- 0 or 1 -
DS_FILTER_
TYPE
Enum(DS_Filter_
Type
- 1 DS_ITEM
A DS_C_SEARCH_CRITERION suggests how to build part of a filter to be used when searching the directory. Its meaning depends on the value of its OM attribute DS_FILTER_TYPE. If the value is DS_ITEM, then the criteria suggests building an instance of OM class DS_C_FILTER_ITEM. If DS_FILTER_TYPE has any other value, it suggests building an instance of OM class DS_C_FILTER.

· DS_ATTRIBUTE_TYPE

This attribute indicates the attribute type to be used in the suggested DS_C_FILTER_ITEM. This OM attribute is only present when the value of DS_FILTER_TYPE is DS_ITEM.

· DS_CRITERIA

This attribute contains nested search criteria. This OM attribute is not present when the value of DS_FILTER_TYPE is DS_ITEM.

· DS_FILTER_ITEM_TYPE

This attribute indicates the type of suggested filter item. Its value can be one of the following:

- DS_APPROXIMATE_MATCH

- DS_EQUALITY

- DS_GREATER_OR_EQUAL

- DS_LESS_OR_EQUAL

- DS_SUBSTRINGS

However, the filter item cannot have the value DS_PRESENT. This OM attribute is only present when the value of DS_FILTER_TYPE is DS_ITEM.

· DS_FILTER_TYPE

This attribute indicates the type of suggested filter. The value DS_ITEM means that the suggested component is a filter item, not a filter. The other values suggest the corresponding type of filter. Its value is one of the following:

- DS_AND

- DS_ITEM

- DS_NOT

- DS_OR