2.2.4.2 Participant-Removed PDU (OD_PARTICIPANT_REMOVED)

The Participant-Removed PDU (OD_PARTICIPANT_REMOVED) is used by the sharing manager to inform the participants that a participant SHOULD be removed from the participant list (section 3.2.5.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

ParticipantId

DiscType

DiscCode

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_REMOVED (0x0007).

ParticipantId (4 bytes):  A 32-bit, unsigned integer that specifies the unique identifier of the participant.

DiscType (4 bytes): A 32-bit, unsigned integer that specifies the disconnect type. Possible values include the following.

Value

Meaning

PARTICIPANT_DISCONNECT_REASON_APP

0x00000000

Indicates that the disconnect was initiated by the host.

PARTICIPANT_DISCONNECT_REASON_CLI

0x00000002

Indicates that the disconnect was initiated by the participant.

DiscCode (4 bytes): A 32-bit, unsigned integer that specifies the reason for the disconnect. A DiscCode beginning with 0x8007 (0x8007xxxx) is a Win32 error code. Other DiscCodes that begin with 0x8 (0x8xxxxxxx) are HRESULT values other than Win32 error codes, such as a standard OLE value like E_ABORT (0x80004004) or an application-specific value. Other possible values include the following.

Value

Meaning

S_OK

0x00000000

The participant was not disconnected because of an error.

0xD00A0006

The disconnect occurred because the sharing manager was unable to send data to the participant.

0xD0000001

The disconnect was the result of an error on the host side.