2.2.4.1 Participant-Created PDU (OD_PARTICIPANT_CREATED)

The Participant-Created PDU (OD_PARTICIPANT_CREATED) is used by the sharing manager to notify participants that a new participant is now receiving the shared desktop. It is also used to notify participants when the control level of a participant has changed (section 3.2.5.2.1)


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

ParticipantId

GroupId

Flags

FriendlyName (variable)

...

HDR (4 bytes): The common PDU header (as specified in Common Order Header (section 2.2.1)). The Type field of the common PDU header MUST be set to ODTYPE_PARTICIPANT_CREATED (0x0008).

ParticipantId (4 bytes): A 32-bit, unsigned integer that specifies the unique identifier of the participant. The ParticipantId is assigned by the sharing manager.

GroupId (4 bytes): A 32-bit, unsigned integer specifying the unique identifier of the group to which the participant belongs. <6>

Flags (2 bytes): A 16-bit, unsigned integer that represents a set of bit flags, in little-endian format, that indicate information about a participant. A bit is true (or set) if its value is 1. This field MUST be composed of the bitwise OR of one or more of the following values.

Value

Meaning

MAY_VIEW

0x0001

The participant has permission to view the shared desktop.

MAY_INTERACT

0x0002

The participant has permission to interact with the shared desktop.

IS_PARTICIPANT

0x0004

The PDU that is associated with the participant receiving the message (section 3.2.5.2.1).

FriendlyName (variable): A UNICODE_STRING that specifies the name that is associated with the participant.