2.2.2.4.4.5 Give Control Reply
The Give Control Reply order accepts or declines the request of the receiver to give control to the sender.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
msg |
|||||||||||||||||||||||||||||||
|
hostControlId |
|||||||||||||||||||||||||||||||
|
mcsPassFrom |
|||||||||||||||||||||||||||||||
|
result |
|||||||||||||||||||||||||||||||
|
viewerControlId |
|||||||||||||||||||||||||||||||
msg (4 bytes): MUST contain the value 0x00000004.
hostControlId (4 bytes): The unique identifier that is used to match requests and replies. This field can contain any 32-bit value but MUST NOT contain 0. The value is not globally unique. This is generated in the local node by incrementing a UINT counter. The counter wraps around if necessary, but 0 is never a valid value.
mcsPassFrom (4 bytes): The user identifier who is passing control. This field MUST be set to 0x00000000 if the host is passing control.
result (4 bytes): One of the following values indicating the response of the sender.
-
Value
Meaning
CARESULT_CONFIRMED
0x00000000
The request was granted.
CARESULT_DENIED
0x00000001
The request was denied.
CARESULT_DENIED_BUSY
0x00000002
The request was denied because the user was occupied.
CARESULT_DENIED_USER
0x00000003
The request was denied because the user rejected the request.
CARESULT_DENIED_WRONGSTATE
0x00000004
The request was denied because the receiver was not in an acceptable state to accept control.
CARESULT_DENIED_TIMEOUT
0x00000005
The request was denied due to user time-out.
viewerControlId (4 bytes): The unique identifier that is used to match requests and replies. This field can contain any 32-bit value but MUST NOT contain 0. The value is not globally unique. This is generated in the local node by incrementing a UINT counter. The counter wraps around if necessary, but 0 is never a valid value.