This topic has not yet been rated - Rate this topic

PidTagRuleState Canonical Property

Office 2007

A value interpreted as a bitmask combination of flags that specify the state of the rule.

The following table defines the possible values of this property.

EN (ST_ENABLED, bitmask 0x00000001): The rule is enabled for execution. If this flag is not set, the server must skip this rule when evaluating rules.

ER (ST_ERROR, bitmask 0x00000002): The server has encountered an error processing the rule.

OF (ST_ONLY_WHEN_OOF, bitmask 0x00000004): The rule is executed only when the user sets the Out of Office (OOF) state on the mailbox. This flag must not be set in a public folder rule.

HI (ST_KEEP_OOF_HIST, bitmask 0x00000008): This flag must not be set in a public folder rule.

EL (ST_EXIT_LEVEL, bitmask 0x00000010): Rule evaluation will end after executing this rule, except for evaluation of Out of Office rules.

SCL (ST_SKIP_IF_SCL_IS_SAFE, bitmask 0x00000020): Evaluation of this rule may be skipped.

PE (ST_RULE_PARSE_ERROR, bitmask 0x00000040): The server has encountered an error parsing the rule data provided by the client.

Note on the interaction between ST_ONLY_WHEN_OOF and ST_EXIT_LEVEL flags:

When the "Out of Office" state is set on the mailbox, and a rule condition evaluates to TRUE,

AND:

The rule has the ST_EXIT_LEVEL flag set and does not have ST_ONLY_WHEN_OOF flag set. Then, the server must not evaluate subsequent rules that do not have ST_ONLY_WHEN_OOF flag set, and must evaluate subsequent rules that have ST_ONLY_WHEN_OOF flag set.

OR:

The rule has both the ST_EXIT_LEVEL and ST_ONLY_WHEN_OOF flags set. Then, the server must not evaluate any subsequent rules.

[MS-OXPROPS]: Provides references to related Exchange Server protocol specifications.

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)