2.2.4 Change Notification Message

A Change Notification Message is used to encapsulate a single change Notification Body (section 2.2.5) sent by a queue manager or several change Notification Updates (section 2.2.6) sent by a directory service. A change notification represents a change on either a queue or a machine object within a directory service.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Version

NumberOfUpdateNotifications

Data (variable)

...

Version (1 byte): A UCHAR containing the version of the notification message. This field MUST be set to the value 0x01 for messages sent by an MSMQ Directory Service and to the value 0x02 for messages sent by an MSMQ queue manager.<5>

Value

Meaning

0x01

Message sent by an MSMQ Directory Service.

0x02

Message sent by an MSMQ queue manager.

NumberOfUpdateNotifications (1 byte): A UCHAR that contains the number of update notifications. This field MUST be set to the number of update notifications contained in the Data field. If the Version field is set to 0x02, this field MUST be set to 0x01.

Data (variable): A variable-length UCHAR array. The content of this field varies depending on the Version field. If the Version field is set to 0x01, this field contains a sequence of Notification Updates (section 2.2.6). If the Version field is set to 0x02, this field contains a single Notification Body (section 2.2.5). There is no padding between Notification Updates.