Important:
This is retired content. 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 content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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 dwMaskis 0, TargetValueis 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 pszand the changed value. If the changed value is type REG_DWORD, then dwMaskis 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 dwMaskto -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
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also