Condividi tramite


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.

See Also

Reference

SRestriction

Concepts

MAPI Structures