2.2.2.1.1.1 General Capability Set (CLIPRDR_GENERAL_CAPABILITY)
The CLIPRDR_GENERAL_CAPABILITY structure is used to advertise general clipboard settings.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
capabilitySetType |
lengthCapability |
||||||||||||||||||||||||||||||
|
version |
|||||||||||||||||||||||||||||||
|
generalFlags |
|||||||||||||||||||||||||||||||
capabilitySetType (2 bytes): An unsigned 16-bit integer that specifies the type of the capability set. This field MUST be set to CB_CAPSTYPE_GENERAL (0x0001).
lengthCapability (2 bytes): An unsigned, 16-bit integer that specifies the length, in bytes, of the capabilitySetType, capability data and lengthCapability fields.
version (4 bytes): An unsigned, 32-bit integer that specifies the Remote Desktop Protocol: Clipboard Virtual Channel Extension version number. This field is for informational purposes and MUST NOT be used to make protocol capability decisions. The actual features supported are specified in the generalFlags field.
-
Value
Meaning
CB_CAPS_VERSION_1
0x00000001
Version 1
CB_CAPS_VERSION_2
0x00000002
Version 2
generalFlags (4 bytes): An unsigned, 32-bit integer that specifies the general capability flags.
-
Value
Meaning
CB_USE_LONG_FORMAT_NAMES
0x00000002
The Long Format Name variant of the Format List PDU is supported for exchanging updated format names. If this flag is not set, the Short Format Name variant MUST be used. If this flag is set by both protocol endpoints, then the Long Format Name variant MUST be used.
CB_STREAM_FILECLIP_ENABLED
0x00000004
File copy and paste using stream-based operations are supported using the File Contents Request PDU and File Contents Response PDU.
CB_FILECLIP_NO_FILE_PATHS
0x00000008
Indicates that any description of files to copy and paste MUST NOT include the source path of the files.
CB_CAN_LOCK_CLIPDATA
0x00000010
Locking and unlocking of File Stream data on the clipboard is supported using the Lock Clipboard Data PDU and Unlock Clipboard Data PDU.
CB_HUGE_FILE_SUPPORT_ENABLED
0x00000020
Indicates support for transferring files that are larger than 4,294,967,295 bytes in size. If this flag is not set, then only files of size less than or equal to 4,294,967,295 bytes can be exchanged using the File Contents Request PDU and File Contents Response PDU.
If the General Capability Set is not present in the Clipboard Capabilities PDU, then the default set of general capabilities MUST be assumed. By definition the default set does not specify any flags in the generalFlags field, that is the generalFlags field is set to 0x00000000.