Filter Properties

The SmsEnumFilters function enables your application to retrieve information about all filter types supported by the SMS API. The properties for each filter type are stored in a FILTER_INFO structure.

By accessing the members of the FILTER_INFO structure, your application can get the following information about the filter type:

szTag

Specifies the string form of the filter's tag. The string has the length specified by NAME_SIZE.

filterType

Specifies the type of the filter. See filter types.

szName

Specifies the string label for the name of the value to be evaluated by an expression.

Note that szName is used by all filter types except machine filters (MACHINE_FILTER) and attribute filters (ATTRIBUTE_FILTER), which use the szAttributeName to specify the name of the attribute to use for the expression. For these two filters, szName is NULL.

szValue

Specifies the string label for the value to be compared using the operator specified by szOperator.

szOperator

Specifies the string label for the name of the operator to be evaluated by an expression.

szArchitecture

Specifies the string label for the name of the architecture of the object to search for. This member is used only for machine filters and attribute filters.

szGroupClass

Specifies the string label for the name of the group class of the attribute specified by szAttributeName. This member is used only for machine filters and attribute filters.

szAttributeName

Specifies the string label for the name of the attribute to evaluate against the value specified by szValue. This member is used only for machine filters and attribute filters.

Note that szName is used by all filter types except machine filters (MACHINE_FILTER) and attribute filters (ATTRIBUTE_FILTER); for all other filters, szAttributeName is NULL.