Skip to content

Adds ClientBuild settings to RDP plugin to specify client version build number

Corresponds to xfreerdp /client-build-number:<number> option.

This parameter is used by Windows server i.a. as simple feature negotiation in Smartcard Reader channel. There is no other way to client to signal smartcard features supported. If not specified, server assumes support for all functions but is prepared for these functions to fail.

See Chapter 1.7 in [RDPESC] specification.

ClientBuild less than 4034 means Windows XP (also 64-bit) and older client with basic set of redirected smartcard functions

Values 4034-7064 mean Windows Vista/7/2008 client and signals support for:

  • SCARD_IOCTL_GETTRANSMITCOUNT
  • SCARD_IOCTL_READCACHEA, SCARD_IOCTL_READCACHEW
  • SCARD_IOCTL_WRITECACHEA, SCARD_IOCTL_WRITECACHEW

Values larger or equal 7065 mean Windows 8 and newer and signals support for:

  • SCARD_IOCTL_GETREADERICON
  • SCARD_IOCTL_GETDEVICETYPEID

See also https://github.com/FreeRDP/FreeRDP/issues/5791#issuecomment-572657122.

This option may be valuable if you don't want to forward these calls from server to client.

I don't know if setting is used for anything else.

Edited by Michał Skalski

Merge request reports

Loading