2.2.2.14.1 Taskbar Tab Info PDU (TS_RAIL_ORDER_TASKBARINFO)
The Taskbar Tab Info PDU is sent from the server to the client when a remote tabbed application adds, removes, or changes the state of a taskbar tab. It is sent only when the client advertises support for the extended shell integration capability (TS_RAIL_LEVEL_SHELL_INTEGRATION_SUPPORTED).
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
header |
|||||||||||||||||||||||||||||||
|
TaskbarMessage |
|||||||||||||||||||||||||||||||
|
WindowIdTab |
|||||||||||||||||||||||||||||||
|
Body |
|||||||||||||||||||||||||||||||
header (4 bytes): A TS_RAIL_PDU_HEADER structure. The orderType field of the header MUST be set to TS_RAIL_ORDER_TASKBARINFO (0x0010).
TaskbarMessage (4 bytes): An unsigned 32-bit integer. Contains the type of tabbed application event that occurred in the remote session. This field MUST be set to one of the following values.
-
Value
Meaning
RAIL_TASKBAR_MSG_TAB_REGISTER
0x00000001
A remote application added a window to its tab group.
RAIL_TASKBAR_MSG_TAB_UNREGISTER
0x00000002
A remote application removed a window from its tab group.
RAIL_TASKBAR_MSG_TAB_ORDER
0x00000003
The position of a window in the tab group order for a remote application has changed. This message SHOULD be sent immediately after a RAIL_TASKBAR_MSG_TAB_REGISTER message.
RAIL_TASKBAR_MSG_TAB_ACTIVE
0x00000004
The active (selected) tab of a remote application tab group has changed.
RAIL_TASKBAR_MSG_TAB_PROPERTIES
0x00000005
The properties of a tab in a remote application tab group have changed.
WindowIdTab (4 bytes): An unsigned 32-bit integer. The window ID of the remote application window whose tab group state is changing.
Body (4 bytes): The contents of this field depend on the TaskbarMessage field. The following table outlines the valid values of the TaskbarMessage field and the corresponding values of the Body field.
-
Value
Meaning
RAIL_TASKBAR_MSG_TAB_REGISTER
0x00000001
The window ID of the window that is being added to the taskbar tab group owned by WindowIdTab.
RAIL_TASKBAR_MSG_TAB_UNREGISTER
0x00000002
Not used. The Body field MUST still be present but SHOULD be set to zero.
RAIL_TASKBAR_MSG_TAB_ORDER
0x00000003
The window ID that the tab owned by WindowIdTab SHOULD be placed immediately before in its tab group. If this value is zero, the tab SHOULD be placed at the end of its tab group.
RAIL_TASKBAR_MSG_TAB_ACTIVE
0x00000004
The window ID corresponding to the tab that SHOULD be set active in the tab group owned by WindowIdTab.
RAIL_TASKBAR_MSG_TAB_PROPERTIES
0x00000005
The properties of the tab corresponding to WindowIdTab that are to be set. Valid properties are described by the [MSDN-STPFLAG] enumeration.