2.2.11 MQPROPERTYRESTRICTION

The MQPROPERTYRESTRICTION structure specifies a logical expression over an MSMQ object property. The logical expression evaluates to TRUE or FALSE. The logical expression is defined through a relational comparison operation between an MSMQ object property and a specified constant value.

 typedef struct tagMQPROPERTYRESTRICTION {
   unsigned long rel;
   unsigned long prop;
   PROPVARIANT prval;
 } MQPROPERTYRESTRICTION;

rel: Specifies the binary relation to be computed between the MSMQ object property identified by prop and the constant specified by prval. The value of this field MUST be one of the values as defined as follows.

Value

Meaning

PRLT

0x00000000

Less than.

PRLE

0x00000001

Less than or equal to.

PRGT

0x00000002

Greater than.

PRGE

0x00000003

Greater than or equal to.

PREQ

0x00000004

Equal to.

PRNE

0x00000005

Not equal to.

prop: A property identifier specifying what MSMQ object property to be used as the left operand in the binary relation specified in rel. MUST be one of the values specified in the object property identifier table, as specified in section 2.2.10.1.

prval: A constant value to be used as the right operand in the binary relation specified in rel. The variant type of prval MUST match the variant type of the MSMQ object property identified by prop as specified in the property identifier tables in section 2.2.10.1.

This structure is used in directory query operations to define a single constraint over the set of directory objects to be returned. An object is deemed to satisfy the constraint if the binary expression, as specified by the MQPROPERTYRESTRICTION structure, evaluates to TRUE, and is deemed not to satisfy the constraint otherwise. See section 3.1.4.17.