Share via


NOTIFICATIONCONDITION

Send Feedback

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

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

OS Versions: Windows CE 5.01 and later.
Header: Regext.h

See Also

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

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.