2 rdesktop: A Remote Desktop Protocol client.
3 Miscellaneous protocol constants
4 Copyright (C) Matthew Chapman 1999-2008
6 This program is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
20 /* TCP port for Remote Desktop Protocol */
21 #define TCP_PORT_RDP 3389
23 #define DEFAULT_CODEPAGE "UTF-8"
24 #define WINDOWS_CODEPAGE "UTF-16LE"
29 ISO_PDU_CR
= 0xE0, /* Connection Request */
30 ISO_PDU_CC
= 0xD0, /* Connection Confirm */
31 ISO_PDU_DR
= 0x80, /* Disconnect Request */
32 ISO_PDU_DT
= 0xF0, /* Data */
33 ISO_PDU_ER
= 0x70 /* Error */
36 /* RDP protocol negotiating constants */
37 enum RDP_NEG_TYPE_CODE
51 enum RDP_NEG_FAILURE_CODE
53 SSL_REQUIRED_BY_SERVER
= 1,
54 SSL_NOT_ALLOWED_BY_SERVER
= 2,
55 SSL_CERT_NOT_ON_SERVER
= 3,
56 INCONSISTENT_FLAGS
= 4,
57 HYBRID_REQUIRED_BY_SERVER
= 5,
58 SSL_WITH_USER_AUTH_REQUIRED_BY_SERVER
= 6
64 MCS_EDRQ
= 1, /* Erect Domain Request */
65 MCS_DPUM
= 8, /* Disconnect Provider Ultimatum */
66 MCS_AURQ
= 10, /* Attach User Request */
67 MCS_AUCF
= 11, /* Attach User Confirm */
68 MCS_CJRQ
= 14, /* Channel Join Request */
69 MCS_CJCF
= 15, /* Channel Join Confirm */
70 MCS_SDRQ
= 25, /* Send Data Request */
71 MCS_SDIN
= 26 /* Send Data Indication */
74 #define MCS_CONNECT_INITIAL 0x7f65
75 #define MCS_CONNECT_RESPONSE 0x7f66
77 #define BER_TAG_BOOLEAN 1
78 #define BER_TAG_INTEGER 2
79 #define BER_TAG_OCTET_STRING 4
80 #define BER_TAG_RESULT 10
81 #define BER_TAG_SEQUENCE 16
82 #define BER_TAG_CONSTRUCTED 0x20
83 #define BER_TAG_CTXT_SPECIFIC 0x80
85 #define MCS_TAG_DOMAIN_PARAMS 0x30
87 #define MCS_GLOBAL_CHANNEL 1003
88 #define MCS_USERCHANNEL_BASE 1001
90 /* RDP secure transport constants */
91 #define SEC_RANDOM_SIZE 32
92 #define SEC_MODULUS_SIZE 64
93 #define SEC_MAX_MODULUS_SIZE 256
94 #define SEC_PADDING_SIZE 8
95 #define SEC_EXPONENT_SIZE 4
97 #define SEC_CLIENT_RANDOM 0x0001
98 #define SEC_ENCRYPT 0x0008
99 #define SEC_LOGON_INFO 0x0040
100 #define SEC_LICENCE_NEG 0x0080
101 #define SEC_REDIRECT_ENCRYPT 0x0C00
103 #define SEC_TAG_SRV_INFO 0x0c01
104 #define SEC_TAG_SRV_CRYPT 0x0c02
105 #define SEC_TAG_SRV_CHANNELS 0x0c03
107 #define SEC_TAG_CLI_INFO 0xc001
108 #define SEC_TAG_CLI_CRYPT 0xc002
109 #define SEC_TAG_CLI_CHANNELS 0xc003
110 #define SEC_TAG_CLI_CLUSTER 0xc004
112 #define SEC_TAG_PUBKEY 0x0006
113 #define SEC_TAG_KEYSIG 0x0008
115 #define SEC_RSA_MAGIC 0x31415352 /* RSA1 */
117 /* Client cluster constants */
118 #define SEC_CC_REDIRECTION_SUPPORTED 0x00000001
119 #define SEC_CC_REDIRECT_SESSIONID_FIELD_VALID 0x00000002
120 #define SEC_CC_REDIRECTED_SMARTCARD 0x00000040
121 #define SEC_CC_REDIRECT_VERSION_MASK 0x0000003c
123 #define SEC_CC_REDIRECT_VERSION_3 0x02
124 #define SEC_CC_REDIRECT_VERSION_4 0x03
125 #define SEC_CC_REDIRECT_VERSION_5 0x04
126 #define SEC_CC_REDIRECT_VERSION_6 0x05
128 /* RDP licensing constants */
129 #define LICENCE_TOKEN_SIZE 10
130 #define LICENCE_HWID_SIZE 20
131 #define LICENCE_SIGNATURE_SIZE 16
133 #define LICENCE_TAG_REQUEST 0x01
134 #define LICENCE_TAG_PLATFORM_CHALLENGE 0x02
135 #define LICENCE_TAG_NEW_LICENCE 0x03
136 #define LICENCE_TAG_UPGRADE_LICENCE 0x04
137 #define LICENCE_TAG_LICENCE_INFO 0x12
138 #define LICENCE_TAG_NEW_LICENCE_REQUEST 0x13
139 #define LICENCE_TAG_PLATFORM_CHALLENGE_RESPONSE 0x15
140 #define LICENCE_TAG_ERROR_ALERT 0xff
142 #define BB_CLIENT_USER_NAME_BLOB 0x000f
143 #define BB_CLIENT_MACHINE_NAME_BLOB 0x0010
148 RDP_PDU_DEMAND_ACTIVE
= 1,
149 RDP_PDU_CONFIRM_ACTIVE
= 3,
150 RDP_PDU_REDIRECT
= 4, /* Standard Server Redirect */
151 RDP_PDU_DEACTIVATE
= 6,
153 RDP_PDU_ENHANCED_REDIRECT
= 10 /* Enhanced Server Redirect */
156 enum RDP_DATA_PDU_TYPE
158 RDP_DATA_PDU_UPDATE
= 2,
159 RDP_DATA_PDU_CONTROL
= 20,
160 RDP_DATA_PDU_POINTER
= 27,
161 RDP_DATA_PDU_INPUT
= 28,
162 RDP_DATA_PDU_SYNCHRONISE
= 31,
163 RDP_DATA_PDU_BELL
= 34,
164 RDP_DATA_PDU_CLIENT_WINDOW_STATUS
= 35,
165 RDP_DATA_PDU_LOGON
= 38, /* PDUTYPE2_SAVE_SESSION_INFO */
166 RDP_DATA_PDU_FONT2
= 39,
167 RDP_DATA_PDU_KEYBOARD_INDICATORS
= 41,
168 RDP_DATA_PDU_DISCONNECT
= 47,
169 RDP_DATA_PDU_AUTORECONNECT_STATUS
= 50
172 enum RDP_SAVE_SESSION_PDU_TYPE
175 INFOTYPE_LOGON_LONG
= 1,
176 INFOTYPE_LOGON_PLAINNOTIFY
= 2,
177 INFOTYPE_LOGON_EXTENDED_INF
= 3
180 enum RDP_LOGON_INFO_EXTENDED_TYPE
182 LOGON_EX_AUTORECONNECTCOOKIE
= 1,
183 LOGON_EX_LOGONERRORS
= 2
186 enum RDP_CONTROL_PDU_TYPE
188 RDP_CTL_REQUEST_CONTROL
= 1,
189 RDP_CTL_GRANT_CONTROL
= 2,
191 RDP_CTL_COOPERATE
= 4
194 enum RDP_UPDATE_PDU_TYPE
196 RDP_UPDATE_ORDERS
= 0,
197 RDP_UPDATE_BITMAP
= 1,
198 RDP_UPDATE_PALETTE
= 2,
199 RDP_UPDATE_SYNCHRONIZE
= 3
202 enum RDP_POINTER_PDU_TYPE
204 RDP_POINTER_SYSTEM
= 1,
205 RDP_POINTER_MOVE
= 3,
206 RDP_POINTER_COLOR
= 6,
207 RDP_POINTER_CACHED
= 7,
211 enum RDP_SYSTEM_POINTER_TYPE
213 RDP_NULL_POINTER
= 0,
214 RDP_DEFAULT_POINTER
= 0x7F00
217 enum RDP_INPUT_DEVICE
219 RDP_INPUT_SYNCHRONIZE
= 0,
220 RDP_INPUT_CODEPOINT
= 1,
221 RDP_INPUT_VIRTKEY
= 2,
222 RDP_INPUT_SCANCODE
= 4,
223 RDP_INPUT_MOUSE
= 0x8001
227 #define KBD_FLAG_RIGHT 0x0001
228 #define KBD_FLAG_EXT 0x0100
229 #define KBD_FLAG_QUIET 0x1000
230 #define KBD_FLAG_DOWN 0x4000
231 #define KBD_FLAG_UP 0x8000
233 /* These are for synchronization; not for keystrokes */
234 #define KBD_FLAG_SCROLL 0x0001
235 #define KBD_FLAG_NUMLOCK 0x0002
236 #define KBD_FLAG_CAPITAL 0x0004
239 #define RDP_KEYPRESS 0
240 #define RDP_KEYRELEASE (KBD_FLAG_DOWN | KBD_FLAG_UP)
242 #define MOUSE_FLAG_MOVE 0x0800
243 #define MOUSE_FLAG_BUTTON1 0x1000
244 #define MOUSE_FLAG_BUTTON2 0x2000
245 #define MOUSE_FLAG_BUTTON3 0x4000
246 #define MOUSE_FLAG_BUTTON4 0x0280
247 #define MOUSE_FLAG_BUTTON5 0x0380
248 #define MOUSE_FLAG_DOWN 0x8000
250 /* Raster operation masks */
251 #define ROP2_S(rop3) (rop3 & 0xf)
252 #define ROP2_P(rop3) ((rop3 & 0x3) | ((rop3 & 0x30) >> 2))
254 #define ROP2_COPY 0xc
257 #define ROP2_NXOR 0x9
260 #define MIX_TRANSPARENT 0
263 #define TEXT2_VERTICAL 0x04
264 #define TEXT2_IMPLICIT_X 0x20
269 /* RDP bitmap cache (version 2) constants */
270 #define BMPCACHE2_C0_CELLS 0x78
271 #define BMPCACHE2_C1_CELLS 0x78
272 #define BMPCACHE2_C2_CELLS 0x150
273 #define BMPCACHE2_NUM_PSTCELLS 0x9f6
275 #define PDU_FLAG_FIRST 0x01
276 #define PDU_FLAG_LAST 0x02
278 /* RDP capabilities */
279 #define RDP_CAPSET_GENERAL 1 /* Maps to generalCapabilitySet in T.128 page 138 */
280 #define RDP_CAPLEN_GENERAL 0x18
281 #define OS_MAJOR_TYPE_UNIX 4
282 #define OS_MINOR_TYPE_XSERVER 7
284 #define RDP_CAPSET_BITMAP 2
285 #define RDP_CAPLEN_BITMAP 0x1C
287 #define RDP_CAPSET_ORDER 3
288 #define RDP_CAPLEN_ORDER 0x58
289 #define ORDER_CAP_NEGOTIATE 2
290 #define ORDER_CAP_NOSUPPORT 4
292 #define RDP_CAPSET_BMPCACHE 4
293 #define RDP_CAPLEN_BMPCACHE 0x28
295 #define RDP_CAPSET_CONTROL 5
296 #define RDP_CAPLEN_CONTROL 0x0C
298 #define RDP_CAPSET_ACTIVATE 7
299 #define RDP_CAPLEN_ACTIVATE 0x0C
301 #define RDP_CAPSET_POINTER 8
302 #define RDP_CAPLEN_POINTER 0x08
303 #define RDP_CAPLEN_NEWPOINTER 0x0a
305 #define RDP_CAPSET_SHARE 9
306 #define RDP_CAPLEN_SHARE 0x08
308 #define RDP_CAPSET_COLCACHE 10
309 #define RDP_CAPLEN_COLCACHE 0x08
311 #define RDP_CAPSET_BRUSHCACHE 15
312 #define RDP_CAPLEN_BRUSHCACHE 0x08
314 #define RDP_CAPSET_BMPCACHE2 19
315 #define RDP_CAPLEN_BMPCACHE2 0x28
316 #define BMPCACHE2_FLAG_PERSIST ((uint32)1<<31)
318 #define RDP_SOURCE "MSTSC"
321 #define RDP_INFO_MOUSE 0x00000001
322 #define RDP_INFO_DISABLECTRLALTDEL 0x00000002
323 #define RDP_INFO_AUTOLOGON 0x00000008
324 #define RDP_INFO_UNICODE 0x00000010
325 #define RDP_INFO_MAXIMIZESHELL 0x00000020
326 #define RDP_INFO_COMPRESSION 0x00000080 /* mppc compression with 8kB history buffer */
327 #define RDP_INFO_ENABLEWINDOWSKEY 0x00000100
328 #define RDP_INFO_COMPRESSION2 0x00000200 /* rdp5 mppc compression with 64kB history buffer */
329 #define RDP_INFO_REMOTE_CONSOLE_AUDIO 0x00002000
330 #define RDP_INFO_PASSWORD_IS_SC_PIN 0x00040000
332 #define RDP5_DISABLE_NOTHING 0x00
333 #define RDP5_NO_WALLPAPER 0x01
334 #define RDP5_NO_FULLWINDOWDRAG 0x02
335 #define RDP5_NO_MENUANIMATIONS 0x04
336 #define RDP5_NO_THEMING 0x08
337 #define RDP5_NO_CURSOR_SHADOW 0x20
338 #define RDP5_NO_CURSORSETTINGS 0x40 /* disables cursor blinking */
340 /* compression types */
341 #define RDP_MPPC_BIG 0x01
342 #define RDP_MPPC_COMPRESSED 0x20
343 #define RDP_MPPC_RESET 0x40
344 #define RDP_MPPC_FLUSH 0x80
345 #define RDP_MPPC_DICT_SIZE 65536
347 #define RDP5_COMPRESSED 0x80
350 #define MapRightShiftMask (1<<0)
351 #define MapLeftShiftMask (1<<1)
352 #define MapShiftMask (MapRightShiftMask | MapLeftShiftMask)
354 #define MapRightAltMask (1<<2)
355 #define MapLeftAltMask (1<<3)
356 #define MapAltGrMask MapRightAltMask
358 #define MapRightCtrlMask (1<<4)
359 #define MapLeftCtrlMask (1<<5)
360 #define MapCtrlMask (MapRightCtrlMask | MapLeftCtrlMask)
362 #define MapRightWinMask (1<<6)
363 #define MapLeftWinMask (1<<7)
364 #define MapWinMask (MapRightWinMask | MapLeftWinMask)
366 #define MapNumLockMask (1<<8)
367 #define MapCapsLockMask (1<<9)
369 #define MapLocalStateMask (1<<10)
371 #define MapInhibitMask (1<<11)
373 #define MASK_ADD_BITS(var, mask) (var |= mask)
374 #define MASK_REMOVE_BITS(var, mask) (var &= ~mask)
375 #define MASK_HAS_BITS(var, mask) ((var & mask)>0)
376 #define MASK_CHANGE_BIT(var, mask, active) (var = ((var & ~mask) | (active ? mask : 0)))
378 /* Clipboard constants, "borrowed" from GCC system headers in
379 the w32 cross compiler
380 this is the CF_ set when WINVER is 0x0400 */
385 #define CF_METAFILEPICT 3
392 #define CF_PENDATA 10
395 #define CF_UNICODETEXT 13
396 #define CF_ENHMETAFILE 14
400 #define CF_OWNERDISPLAY 128
401 #define CF_DSPTEXT 129
402 #define CF_DSPBITMAP 130
403 #define CF_DSPMETAFILEPICT 131
404 #define CF_DSPENHMETAFILE 142
405 #define CF_PRIVATEFIRST 512
406 #define CF_PRIVATELAST 767
407 #define CF_GDIOBJFIRST 768
408 #define CF_GDIOBJLAST 1023
411 /* Sound format constants */
412 #define WAVE_FORMAT_PCM 1
413 #define WAVE_FORMAT_ADPCM 2
414 #define WAVE_FORMAT_ALAW 6
415 #define WAVE_FORMAT_MULAW 7
417 /* Virtual channel options */
418 #define CHANNEL_OPTION_INITIALIZED 0x80000000
419 #define CHANNEL_OPTION_ENCRYPT_RDP 0x40000000
420 #define CHANNEL_OPTION_COMPRESS_RDP 0x00800000
421 #define CHANNEL_OPTION_SHOW_PROTOCOL 0x00200000
423 /* NT status codes for RDPDR */
424 #define RD_STATUS_SUCCESS 0x00000000
425 #define RD_STATUS_NOT_IMPLEMENTED 0x00000001
426 #define RD_STATUS_PENDING 0x00000103
428 #define RD_STATUS_NO_MORE_FILES 0x80000006
429 #define RD_STATUS_DEVICE_PAPER_EMPTY 0x8000000e
430 #define RD_STATUS_DEVICE_POWERED_OFF 0x8000000f
431 #define RD_STATUS_DEVICE_OFF_LINE 0x80000010
432 #define RD_STATUS_DEVICE_BUSY 0x80000011
434 #define RD_STATUS_INVALID_HANDLE 0xc0000008
435 #define RD_STATUS_INVALID_PARAMETER 0xc000000d
436 #define RD_STATUS_NO_SUCH_FILE 0xc000000f
437 #define RD_STATUS_INVALID_DEVICE_REQUEST 0xc0000010
438 #define RD_STATUS_ACCESS_DENIED 0xc0000022
439 #define RD_STATUS_OBJECT_NAME_COLLISION 0xc0000035
440 #define RD_STATUS_DISK_FULL 0xc000007f
441 #define RD_STATUS_FILE_IS_A_DIRECTORY 0xc00000ba
442 #define RD_STATUS_NOT_SUPPORTED 0xc00000bb
443 #define RD_STATUS_TIMEOUT 0xc0000102
444 #define RD_STATUS_NOTIFY_ENUM_DIR 0xc000010c
445 #define RD_STATUS_CANCELLED 0xc0000120
446 #define RD_STATUS_DIRECTORY_NOT_EMPTY 0xc0000101
448 /* RDPSND constants */
449 #define TSSNDCAPS_ALIVE 0x00000001
450 #define TSSNDCAPS_VOLUME 0x00000002
452 /* RDPDR constants */
454 #define RDPDR_CTYP_CORE 0x4472
455 #define RDPDR_CTYP_PRN 0x5052
457 #define PAKID_CORE_SERVER_ANNOUNCE 0x496e
458 #define PAKID_CORE_CLIENTID_CONFIRM 0x4343
459 #define PAKID_CORE_CLIENT_NAME 0x434e
460 #define PAKID_CORE_DEVICE_LIST_ANNOUNCE 0x4441
461 #define PAKID_CORE_DEVICE_REPLY 0x6472
462 #define PAKID_CORE_DEVICE_IOREQUEST 0x4952
463 #define PAKID_CORE_DEVICE_IOCOMPLETION 0x4943
464 #define PAKID_CORE_SERVER_CAPABILITY 0x5350
465 #define PAKID_CORE_CLIENT_CAPABILITY 0x4350
466 #define PAKID_CORE_DEVICELIST_REMOVE 0x444d
467 #define PAKID_PRN_CACHE_DATA 0x5043
468 #define PAKID_CORE_USER_LOGGEDON 0x554c
469 #define PAKID_PRN_USING_XPS 0x5543
471 #define RDPDR_MAX_DEVICES 0x10
472 #define DEVICE_TYPE_SERIAL 0x01
473 #define DEVICE_TYPE_PARALLEL 0x02
474 #define DEVICE_TYPE_PRINTER 0x04
475 #define DEVICE_TYPE_DISK 0x08
476 #define DEVICE_TYPE_SCARD 0x20
478 #define FILE_DIRECTORY_FILE 0x00000001
479 #define FILE_NON_DIRECTORY_FILE 0x00000040
480 #define FILE_COMPLETE_IF_OPLOCKED 0x00000100
481 #define FILE_DELETE_ON_CLOSE 0x00001000
482 #define FILE_OPEN_FOR_FREE_SPACE_QUERY 0x00800000
484 /* RDP5 disconnect PDU */
485 #define exDiscReasonNoInfo 0x0000
486 #define exDiscReasonAPIInitiatedDisconnect 0x0001
487 #define exDiscReasonAPIInitiatedLogoff 0x0002
488 #define exDiscReasonServerIdleTimeout 0x0003
489 #define exDiscReasonServerLogonTimeout 0x0004
490 #define exDiscReasonReplacedByOtherConnection 0x0005
491 #define exDiscReasonOutOfMemory 0x0006
492 #define exDiscReasonServerDeniedConnection 0x0007
493 #define exDiscReasonServerDeniedConnectionFips 0x0008
494 #define exDiscReasonServerInsufficientPrivileges 0x0009
495 #define exDiscReasonServerFreshCredentialsRequired 0x000a
496 #define exDiscReasonRPCInitiatedDisconnectByUser 0x000b
497 #define exDiscReasonByUser 0x000c
498 #define exDiscReasonLicenseInternal 0x0100
499 #define exDiscReasonLicenseNoLicenseServer 0x0101
500 #define exDiscReasonLicenseNoLicense 0x0102
501 #define exDiscReasonLicenseErrClientMsg 0x0103
502 #define exDiscReasonLicenseHwidDoesntMatchLicense 0x0104
503 #define exDiscReasonLicenseErrClientLicense 0x0105
504 #define exDiscReasonLicenseCantFinishProtocol 0x0106
505 #define exDiscReasonLicenseClientEndedProtocol 0x0107
506 #define exDiscReasonLicenseErrClientEncryption 0x0108
507 #define exDiscReasonLicenseCantUpgradeLicense 0x0109
508 #define exDiscReasonLicenseNoRemoteConnections 0x010a
510 /* SeamlessRDP constants */
511 #define SEAMLESSRDP_NOTYETMAPPED -1
512 #define SEAMLESSRDP_NORMAL 0
513 #define SEAMLESSRDP_MINIMIZED 1
514 #define SEAMLESSRDP_MAXIMIZED 2
515 #define SEAMLESSRDP_POSITION_TIMER 200000
517 #define SEAMLESSRDP_CREATE_MODAL 0x0001
518 #define SEAMLESSRDP_CREATE_TOPMOST 0x0002
520 #define SEAMLESSRDP_HELLO_RECONNECT 0x0001
521 #define SEAMLESSRDP_HELLO_HIDDEN 0x0002
523 /* Smartcard constants */
524 #define SCARD_LOCK_TCP 0
525 #define SCARD_LOCK_SEC 1
526 #define SCARD_LOCK_CHANNEL 2
527 #define SCARD_LOCK_RDPDR 3
528 #define SCARD_LOCK_LAST 4
531 /* redirect flags, from [MS-RDPBCGR] 2.2.13.1 */
532 enum RDP_PDU_REDIRECT_FLAGS
534 PDU_REDIRECT_HAS_IP
= 0x1,
535 PDU_REDIRECT_HAS_LOAD_BALANCE_INFO
= 0x2,
536 PDU_REDIRECT_HAS_USERNAME
= 0x4,
537 PDU_REDIRECT_HAS_DOMAIN
= 0x8,
538 PDU_REDIRECT_HAS_PASSWORD
= 0x10,
539 PDU_REDIRECT_DONT_STORE_USERNAME
= 0x20,
540 PDU_REDIRECT_USE_SMARTCARD
= 0x40,
541 PDU_REDIRECT_INFORMATIONAL
= 0x80,
542 PDU_REDIRECT_HAS_TARGET_FQDN
= 0x100,
543 PDU_REDIRECT_HAS_TARGET_NETBIOS
= 0x200,
544 PDU_REDIRECT_HAS_TARGET_IP_ARRAY
= 0x800