Wireless Communication Library year 2019 changes

• The WiFiClient demo application has been updated to show how to get a Wi-Fi profile password as plain text.
• New error code: WCL_E_WIFI_INTERFACE_NOT_CONNECTED.
• New error code: WCL_E_WIFI_INTERFACE_OPEN_IP_SETTINGS_FAILED.
• New error code: WCL_E_WIFI_INTERFACE_READ_IP_FAILED.
• New error code: WCL_E_WIFI_INTERFACE_SET_IP_FAILED.
• New error code: WCL_E_WIFI_NETCFG_PREPARE_FAILED.
• New error code: WCL_E_WIFI_NETCFG_CREATE_FAILED.
• New error code: WCL_E_WIFI_NETCFG_LOCK_CREATE_FAILED.
• New error code: WCL_E_WIFI_NETCFG_LOCK_FAILED.
• New error code: WCL_E_WIFI_NETCFG_INIT_FAILED.
• New error code: WCL_E_WIFI_NETCFG_ENUM_INTERFACES_FAILED.
• New error code: WCL_E_WIFI_NETCFG_INTERFACE_NOT_FOUND.
• New error code: WCL_E_WIFI_NETCFG_PROTOCOL_NOT_FOUND.
• New error code: WCL_E_WIFI_NETCFG_SWITCH_PROTOCOL_FAILED.
• New error code: WCL_E_WIFI_NETCFG_APPLY_CHANGES_FAILED.
• New error code: WCL_E_WIFI_NETCFG_START_THREAD_FAILED.
• Reading current IP address for the connected Wi-Fi interface.
• The WiFiClient demo application updated to show how to read the current IP address of a Wi-Fi interface.
• Reading Wi-Fi interface IP settings.
• The WiFiClient demo application updated to show how to read Wi-Fi interface IP settings.
• Changing IP settings for a Wi-Fi interface; administrative rights are required.
• The WiFiClient demo application updated to show how to change IP settings for the Wi-Fi interface.

Wi-Fi Framework

• The IsRemoteDeviceInRange method now returns an error if used with a BLE device.
• Fixed the issue with resetting the pairing device address in the OnAuthenticationCompleted event.
• Fixed the issue that allowed you to call asynchronous methods (Pair, Discover) when the Bluetooth radio is closing.
• Mixing in the error codes (WCL_E_BLUETOOTH_DEVICE_NOT_CONNECTED vs. WCL_E_BLUETOOTH_DEVICE_NOT_INSTALLED) has been fixed.
• Fixed the issue with multiple OnAuthenticationCompleted events calling for the same device.

Bluetooth Framework

• Fixed the minor bug in the WiFiClient demo application.
• Fixed the issue when a message receiver may cause an application to freeze.

Wi-Fi Framework

• Fixed the issue when a message receiver may cause an application to freeze.

Serial Framework

• Fixed the issue with connecting to the paired BLE device (when the real connection executed only after value reading).
• Fixed the issue when the Close method of the BluetoothManager class may cause an application to freeze.
• Fixed the issue when a message receiver may cause an application to freeze.

Bluetooth Framework

• Reading OS version reworked for faster operation.
• Code refactoring.
• .NET Edition: Some demo applications have been updated.

Wi-Fi Framework

• Reading OS version reworked for faster operation.
• Code refactoring.
• .NET Edition: Some demo applications have been updated.

Serial Framework

• Classic devices pairing with the Microsoft Bluetooth driver has been reworked.
• BLE pairing with the Microsoft Bluetooth driver has been reworked.
• The BLE pairing protection level has been added for BLE pairing.
• The BluetoothManager demo has been updated to show how to use new BLE pairing features.
• Reading OS version reworked for faster operation.
• Code refactoring.
• .NET Edition: Some demo applications have been updated.

Bluetooth Framework

• C++ Edition: A possible conflict with the devpropdef.h header file has been resolved.
• C++ Edition: A possible conflict with the cfgmgr32.h header file has been resolved.

Wi-Fi Framework

• C++ Edition: The Visual Studio 2019 support has been added.
• C++ Edition: A possible conflict with the devpropdef.h header file has been resolved.
• C++ Edition: A possible conflict with the cfgmgr32.h header file has been resolved.

Serial Framework

• GATT Client: The cleanup after disconnect has been fixed.
• GATT Client: Now it executes a real connection to a device.
• GATT Client: The extended error decoding during reading GATT attributes was added.
• C++ Edition: A possible conflict with the devpropdef.h header file has been resolved.
• C++ Edition: A possible conflict with the cfgmgr32.h header file has been resolved.

Bluetooth Framework

• GATT Client: The ability to write a null (empty) value to characteristics was added.
• GATT Client: The ability to read a null (empty) value from characteristics was added.
• GATT Client: The characteristic change notification with a null (empty) value is now possible.

Bluetooth Framework

• Fixed the bug with a Bluetooth radio state switching in console applications.

Bluetooth Framework

• C++ Edition: The Visual Studio 2019 support was added.
• New error code: WCL_E_WIFI_ONE_OF_MORE_BSS_IS_INVALID.
• The new Connect method that allows you to connect to a BSS list was added.
• Connect to a BSS list.

Wi-Fi Framework

• C++ Edition: The Visual Studio 2019 support was added.
• It is possible to run a few instances of the Bluetooth LE advertiser on the Windows 10 platform with the Microsoft Bluetooth driver. However, when you stop one advertiser, the system stops all advertising completely. This release adds new behavior to the Bluetooth LE advertiser so when one of them is stopped, all others are stopped also. This allows to call the OnStopped event of all Bluetooth LE advertisers to notify an application about advertising that has been stopped and to switch all the advertisers to a consistent state.

Bluetooth Framework

• New error code: WCL_E_BLUETOOTH_GET_REMOTE_ADDRESS_TYPE_FAILED.
• New error code: WCL_E_BLUETOOTH_UNKNOWN_DEVICE_TYPE.
• Read a Bluetooth LE device address type.
• The BluetoothManager demo has been updated to show how to get a Bluetooth LE device address type.

Bluetooth Framework

• New error code: WCL_E_BLUETOOTH_GET_REMOTE_ADDRESS_TYPE_FAILED.
• New error code: WCL_E_BLUETOOTH_UNKNOWN_DEVICE_TYPE.
• Read Bluetooth LE device address type.
• The BluetoothManager demo has been updated to show how to get a Bluetooth LE device address type.

Bluetooth Framework

• C++ Edition: Fixed the bug with reading BLE devices pairing status.
• C++ Edition: Fixed the bug with unpairing BLE devices.
• Pairing with BLE devices.

Bluetooth Framework

• Disconnecting the Wi-Fi Direct client and server without a device unpairing.
• Get a Wi-Fi Direct device pairing status.
• Unpairing Wi-Fi Direct device.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_GET_PAIRED_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_START_UNPAIR_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_START_GET_PAIRED_THREAD_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_START_UNPAIR_THREAD_FAILED.

Wi-Fi Framework

• Fixed the issue when the Discover method crashes when Timeout was set to 0.
• The GetRemoteDeviceType method has been reworked to make it work more stably with the latest Windows 10 versions.
• New exception: wclEGattServer.
• Fixed the issue that was caused by a Windows 10 bug that prevented working with paired BLE devices.
• Additional checks for classic discovering timeout have been added.
• The GATT server has been added.
• New error code: WCL_E_BLUETOOTH_GET_LOCAL_OOB_FAILED.
• New error code: WCL_E_BLUETOOTH_DISCOVERING_TIMEOUT_TOO_HIGH.
• New error code: WCL_E_BLUETOOTH_DISCOVERING_TIMEOUT_TOO_LOW.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CHARACTERISTIC_ADDED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CHARACTERISTIC_REMOVED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SERVICE_ADDED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SERVICE_REMOVED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_RUNNING.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_NOT_RUNNING.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CREATE_INIT_EVENT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CREATE_TERM_EVENT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CREATE_THREAD_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_GET_SERVICE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CREATE_PARAMS_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_READ_PROTECTION_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_WRITE_PROTECTION_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_PROPERTIES_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CREATE_CHARACTERISTIC_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_INVALID_CHARACTERISTIC.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_ADV_PARAMS_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_PERIPHERAL_MODE_NOT_SUPPORTED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_START_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CREATE_SERVICE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_INVALID_SERVICE.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_NOT_INITIALIZED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_INITIALIZED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_WRITE_EVENT_HANDLER_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_READ_EVENT_HANDLER_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SET_CLIENTS_CHANGED_EVENT_HANDLER_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_GET_CLIENTS_LIST_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_GET_CLIENTS_COUNT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CHARACTERISTIC_NOT_NOTIFIABLE.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_CHARACTERISTIC_SEND_NOTIFICATION_FAILED.

Bluetooth Framework

• The new "OpenAuth" property has been added to the wclWiFiDirectAdvertiser and wclWiFiSoftAP classes. Setting this property to True forces the wclWiFiDirectAdvertiser (when it is in legacy mode) and the wclWiFiSoftAP classes to switch to the open authentication mode (only when the device runs in the embedded mode).
• The behavior of the "Passphrase" property has been restored. If the passphrase is not provided, the autogenerated one will be used. If the "OpenAuth" property is set to True, the empty passphrase will be used.
• The new Start method has been added to the wclWiFiSoftAP class. The method takes only one argument, "SSID", and starts the Wi-Fi Direct legacy SoftAP in the open authentication mode (only when the device runs in embedded mode).
• Fixed the freezing issue in the Wi-Fi Direct classes when a Wi-Fi hardware has been removed.

Wi-Fi Framework

• Fixed the bug in the wclThread class that causes freezing if the OnInitialize event returns False.
• The WiFiDirect SoftAP allows you to set an empty password to create an open network in case your device is running in the embedded mode.

Wi-Fi Framework

• Fixed the bug in the wclThread class that causes freezing if the OnInitialize event returns False.

Serial Framework

• Fixed the bug in the wclThread class that causes freezing if the OnInitialize event returns False.
• The "Mitm" parameter has been removed from the RemotePair method.
• BlueSoleil: Fixed the issue when pairing result is always success in case of pairing has been initiated by a remote device.
• The new OnIoCapabilityRequest event has been added to the wclBluetoothManager class.
• The BluetoothManager demo application has been updated to show how to specify MITM protection.
• The BluetoothManager demo application has been updated to show how to specify IO capability.
• C++ Edition: Fixed the access violation bug when reading the device's properties when the device MAC is not available or wrong.

Bluetooth Framework

• Refactoring and optimization in the Microsoft Bluetooth LE WinRT code.
• The Bluetooth authentication messages have been redesigned to support WinRT (or other synchronous) pairing.
• The legacy GATT pairing code for the Microsoft Bluetooth driver has been refactored.
• The Bluetooth LE discovering code for the Microsoft Bluetooth driver has been refactored.
• The Bluetooth classic discovering code for the Microsoft Bluetooth driver has been refactored.
• The Bluetooth classic pairing code for the Microsoft Bluetooth driver has been refactored.
• Fixed the issue with reading device type on Windows versions before Windows 8 with the Microsoft Bluetooth driver.
• Fixed the issue with reading Bluetooth LE device connected status.
• Fixed the issue with reading Bluetooth LE device paired status.
• The MITM protection for classic pairing is now supported (Microsoft Bluetooth drivers only on Windows Vista SP2 and above).
• The BluetoothManager demo application has been updated to show how to discover BLE devices (refer to the GattClient demo application to find a code example that shows how to work with BLE GATT-enabled devices, read GATT services and characteristics, and other GATT-related code).
• The BluetoothManager demo application has been updated to show how to use MITM protection during pairing.
• New error code: WCL_E_BLUETOOTH_LE_START_GET_DEV_CONNECTED_STATUS_THREAD_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DEV_CONNECTED_STATUS_THREAD_GET_RESULT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CONNECTED_STATUS_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_START_GET_DEV_PAIRED_STATUS_THREAD_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DEV_PAIRED_STATUS_THREAD_GET_RESULT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DEVICE_PAIRED_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_PROTOCOL_ERROR.
• .NET Edition: Fixed the bug in the RfCommServer WPF demo application.

Bluetooth Framework

• .NET Edition: Fixed the bug in the wclBeaconLeBeaconWatcher that prevents reading the advertising device's name when it runs under Unity.
• The new IsRemoteDeviceInRange method was added to the wclBluetoothRadio class. The method allows you to check if a remote Bluetooth device is available.
• Additional parameters checking in the wclBluetoothRadio class methods.
• .NET Edition: Fixed the bug when a device stays connected after RSSI measurement if the device was disconnected before the RSSI query.

Bluetooth Framework

• The Wireless Communication library common runtime refactoring.
• The WinUSB error codes have been changed.
• .NET Edition: Removed some Win32 API dependencies.
• If you need to convert an error code to the human-readable text, you can use this XML file.

Wi-Fi Framework

• The Wireless Communication library common runtime refactoring.
• The WinUSB error codes have been changed.
• .NET Edition: Removed some Win32 API dependencies.
• If you need to convert an error code to the human-readable text, you can use this XML file.

Serial Framework

• The Wireless Communication library common runtime refactoring.
• The WinUSB error codes have been changed.
• .NET Edition: Removed some Win32 API dependencies.
• If you need to convert an error code to the human-readable text, you can use this XML file.

Bluetooth Framework

• Reading a USB device's setup class GUID.
• Getting a USB device enabled state.
• New error code: WCL_E_SERIAL_DEVICE_SWITCH_FAILED.
• Enabling USB devices.
• Disabling USB devices.
• .NET Edition: The new function ReadDeviceInformation was added to the wclSerialHelpers class.
• .NET Edition: Fixed the bug when not all USB devices were enumerated on Windows 10 IoT.

Serial Framework

• The APC synchronization has been added.
• .NET Edition: The new function SleepEx was added to the wclHelpers class.

Wi-Fi Framework

• The APC synchronization has been added.
• .NET Edition: The new function SleepEx was added to the wclHelpers class.

Serial Framework

• The APC synchronization has been added.
• The new ApcSync demo application was added to show how to use APC synchronization.
• The RfCommServer demo application has been updated to show how to provide a service UUID and a service name.
• The RfCommClient demo application has been updated to show how to find and connect to a service by its channel number.
• .NET Edition: The new function SleepEx was added to the wclHelpers class.
• New error code: WCL_E_BLUETOOTH_WAIT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_OPERATION_RESULT_FAULED.
• New error code: WCL_E_BLUETOOTH_LE_GET_ROOT_SERVICE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_SERVICE_HANDLE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISTIC_HANDLE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTOR_HANDLE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTOR_UUID_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMATS_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMATS_LIST_SIZE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMAT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMAT_TYPE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMAT_EXPONENT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMAT_UNIT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMAT_NAMESPACE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_PRESENTATION_FORMAT_DESCRIPTION_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTOR_VALUE_SIZE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTOR_VALUE_RAW_DATA_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTOR_VALUE_DATA_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISTIC_UUID_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISTIC_PROPETIES_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTOR_VALUE_DATA_BUFFER_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISTIC_VALUE_DATA_BUFFER_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISTIC_VALUE_SIZE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISITC_VALUE_RAW_DATA_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISITC_VALUE_DATA_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_DESCRIPTORS_LIST_SIZE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_SERVICE_UUID_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_CHARACTERISITCS_LIST_SIZE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_SERVICES_LIST_SIZE_FAILED.

Bluetooth Framework

• Minor updates in the Bluetooth pairing code.
• The RemotePair function now checks that a device is not paired. If the device is paired, the function returns an error code.
• The RemoteUnpair function now checks that a device is paired. If the device is not paired, the function returns an error code.

Bluetooth Framework

• Now a Wi-Fi Direct device does not reset its MAC addresses when disconnected.
• Fixed the issue with incorrect OS version detection that appeared in some situations.

Wi-Fi Framework

• Fixed the issue with incorrect OS version detection that appeared in some situations.

Serial Framework

• Fixed the issue with incorrect OS version detection that appeared in some situations.
• Radio turning on and off code has been reworked to support Windows 8 and Windows 8.1.
• Error codes have been changed and updated.

Bluetooth Framework

• .NET Edition: The exception classes have been updated to raise exceptions with messages.
• C++ Edition: The Wi-Fi Framework exceptions now inherit from std::exception to provide access to the What method.
• C++ Edition: The exception classes have been updated to raise exceptions with messages.

Wi-Fi Framework

• .NET Edition: The exception classes have been updated to raise exceptions with messages.
• C++ Edition: The Serial Framework exceptions now inherit from std::exception to provide access to the What method.
• C++ Edition: The exception classes have been updated to raise exceptions with messages.

Serial Framework

• New error code: WCL_E_BLUETOOTH_DEVICE_ALREADY_INSTALLED.
• New error code: WCL_E_BLUETOOTH_DEVICE_NOT_INSTALLED.
• New error code: WCL_E_BLUETOOTH_DEVICE_NOT_CONNECTED.
• New error code: WCL_E_BLUETOOTH_ENUM_CONNECTION_FAILED.
• Installing and uninstalling a Bluetooth device. This feature is available for the BlueSoleil and Microsoft Bluetooth drivers only and can be used to connect (install) and to disconnect (uninstall) Bluetooth devices such as Bluetooth speakers, mice, keyboards, and some other non-RFCOMM-based devices.
• .NET Edition: Some errors decoding for the Microsoft Bluetooth driver have been fixed.
• .NET Edition: The exception classes have been updated to raise exceptions with messages.
• .NET Edition: Fixed the marshaling bug when the Bluetooth Framework runs with the BlueSoleil Bluegooth driver.
• C++ Edition: The Bluetooth Framework exceptions now inherit from std::exception to provide access to the What() method.
• C++ Edition: The exception classes have been updated to raise exceptions with messages.
• VCL Edition: Some errors decoding for the Microsoft Bluetooth driver have been fixed.

Bluetooth Framework

• Reset the data stream position to zero before calling the OnPutCompleted event in the OPP server data processor.

Serial Framework

• BLE device disconnect improved.
• Reset the data stream position to zero before calling the OnPutCompleted event in the OPP server data processor.

Bluetooth Framework

• Fixed issue that prevents rediscovering Bluetooth devices if the Discover method was called from the OnDiscoveringCompleted event handler.
• C++ Edition: Fixed the "Unresolved external" error in the GetTimeout method of the CwclRfCommClient class.

Bluetooth Framework

• The new wclCustomServerClientDataProcessor class that allows you to implement server data processors was added.
• Fixed the issue with processing the ABORT command in the OBEX client implementation.
• The OBEX Object Push server was added.
• New error code: WCL_E_OBEX_CREATE_CONNECTION_ID_MUTEX_FAILED.
• New error code: WCL_E_OBEX_MAX_CONNECTION_ID.
• New error code: WCL_E_OBEX_INVALID_STATE.
• C++ Edition: Fixed the critical bug in the CwclMemoryStream class that causes access violation error.

Serial Framework

• C++ Edition: Fixed the critical bug in the CwclMemoryStream class that causes access violation error.

Wi-Fi Framework

• The OppServer demo application has been updated to show how to save a received file.
• C++ Edition: Fixed the critical bug in the CwclMemoryStream class that causes access violation error.
• .NET Edition: Fixed the bug in the OBEX object name and description reading.

Bluetooth Framework