NOTIFICATIONCONDITION (Compact 2013)

  • Article

3/28/2014

This structure defines the condition that determines when to send property change notification.

Syntax

typedef struct tagNOTIFICATIONCONDITION {
   REG_COMPARISONTYPE ctComparisonType;
   DWORD dwMask;
   union TargetValue {
      LPCTSTR psz;
      DWORD dw;
      };
} NOTIFICATIONCONDITION;

Members

  • ctComparisonType
    Determines how to compare the changed registry value with the TargetValue. For more information, see REG_COMPARISONTYPE.

  • dwMask
    Applies only to DWORD values. This mask is applied to the changed registry value before comparison. By specifying a bit mask, the Notifications Broker notifies the clients only when specific bits in the registry value changes.

    This mask is not applied to TargetValue. If dwMask is 0, TargetValue is treated as a string (type REG_SZ), otherwise it is treated as type REG_DWORD.

  • TargetValue
    If the changed value is type REG_SZ, then comparison is done between psz and the changed value. If the changed value is type REG_DWORD, then dwMask is applied to the changed value and then the result is compared to dw. If the changed value is neither REG_SZ nor REG_DWORD, then notification is sent without any comparison. You must set dwMask to -1 to test against the whole doubleword.

Remarks

When the registry value changes, the client can request a comparison between the changed value and a target value. The Notifications Broker sends change notifications only when the comparison is TRUE. For DWORD registry values, an optional mask can be applied to the changed registry value before the comparison is made.

Requirements

Header

regext.h

See Also

Reference

State and Notifications Broker Structures
State and Notifications Broker Reference
REG_COMPARISONTYPE
RegistryNotifyApp
RegistryNotifyWindow
RegistryNotifyMsgQueue
RegistryNotifyCallback