SBitMaskRestriction
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Describes a bitmask restriction, which is used to perform a bitwise AND operation and test the result.
Header file: |
Mapidefs.h |
typedef struct _SBitMaskRestriction
{
ULONG relBMR;
PT_LONG ulPropTag;
ULONG ulMask;
} SBitMaskRestriction;
Members
relBMR
Relational operator that describes how the mask specified in the ulMask member should be applied to the property tag. Possible values are as follows:BMR_EQZ
Perform a bitwise AND operation of the mask in the ulMask member with the property represented by the ulPropTag member and test for being equal to zero.BMR_NEZ
Perform a bitwise AND operation of the mask in the ulMask member with the property represented by the ulPropTag member and test for being not equal to zero.
ulPropTag
Property tag of the property to which the bitmask is applied.ulMask
Bitmask to apply to the property identified by ulPropTag.
Remarks
The SBitMaskRestriction structure performs a bitwise AND operation using the bitmask described in the ulMask member and the value of the property described by the ulPropTag member. If the result is zero, BMR_EQZ is satisfied. If it is nonzero, that is, if the property value has at least one of the same bits set as ulMask, then BMR_NEZ is satisfied.
For more information about the SBitMaskRestriction structure and restrictions in general, see About Restrictions.