2.2.1.3.1.2.3 Cached Icon

  • Article

The Cached Icon Window Information Order is generated by the server when a new or existing window sets or updates the icon in its title bar or in the Alt-Tab dialog box. If the icon information was transmitted by the server in a previous Window Information Order or Notification Icon Information Order in the same session, and the icon was cacheable (that is, the server specified a CacheEntry and CacheId for the icon), the server reports the icon cache entries to avoid sending duplicate information.

The Cached Icon packet SHOULD NOT be sent if the client specified the TS_RAIL_CLIENTSTATUS_SUPPRESS_ICON_ORDERS flag in the Client Information PDU (section 2.2.2.2.2).


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

Hdr

...

...

CachedIcon

...

Hdr (11 bytes): Eleven bytes. A TS_WINDOW_ORDER_HEADER (section 2.2.1.3.1.1) structure. The FieldsPresentFlags field of the header MUST conform to the values defined as follows.

Value

Description

0x01000000

WINDOW_ORDER_TYPE_WINDOW

Indicates a Windowing Alternate Secondary Drawing Order that describes a window. This flag MUST be set.

0x10000000

WINDOW_ORDER_STATE_NEW

Indicates that the Windowing Alternate Secondary Drawing Order contains information for a new window. If this flag is not set, the order contains information for an existing window.

0x80000000

WINDOW_ORDER_CACHEDICON

Indicates that the order contains cached icon information for the window. This flag MUST be set.

0x00002000

WINDOW_ORDER_FIELD_ICON_BIG

Indicates that the large version of the icon is being referred to. If this flag is not present, the icon is a small icon. <9>

0x00100000

WINDOW_ORDER_FIELD_ICON_OVERLAY

Indicates that the overlay icon for the window is being referred to. If this flag is not present, the icon is an application icon.

CachedIcon (3 bytes): Three bytes. TS_CACHED_ICON_INFO (section 2.2.1.2.4) structure. Describes a cached icon on the client.