|SocketTools 9.3 Upgrade Information|
This section will help you upgrade an application written using a previous version of the SocketTools ActiveX Edition. In most cases, the modifications required will be minimal and may only require a few edits and recompiling the program. However, it is recommended that you review this entire guide so that you understand what changes were made and how those changes can be implemented in your software.
SocketTools 9.3 is supported on Windows XP SP3 and later versions of Windows, including Windows 8.1 and Windows Server 2012 R2. Earlier versions of the operating system, including Windows 95, Windows 98, Windows Me, Windows NT 4.0 and Windows 2000 are no longer supported by Microsoft and are not compatible with SocketTools.
Developers who are redistributing applications which target Windows Vista or later versions of the operating system should upgrade to the current version of the SocketTools ActiveX Edition to ensure compatibility with the platform. It is also recommended that you review the Microsoft Developers Network website and familiarize yourself with how the User Account Control (UAC) system works.
The SocketTools 9.3 ActiveX controls may be used with any programming language that supports the Component Object Model (COM) and ActiveX control interface. This includes languages such as Visual Basic 6.0, Visual FoxPro and PowerBuilder. Although the ActiveX controls may be used with Visual Basic .NET and Visual C#, it is strongly recommended that you use the SocketTools .NET Edition if you are creating applications for the .NET Framework.
If you are developing on Windows Vista, Microsoft only supports Visual Studio 2005 or later versions. If you are developing on the Windows 7 or Windows 8 desktop platform, it is recommended that you use Visual Studio 2010 or a later version. Earlier versions of Visual Studio may require that you use those development tools with elevated privileges. If you are using Visual Studio 6.0 or Visual Studio .NET 2003 and cannot upgrade to the current version of Visual Studio, Microsoft recommends that you continue to develop on the Windows XP platform.
Upgrading From Version 8.0
If you are upgrading from SocketTools 8.0, most applications will be source code compatible and not require significant changes to existing code. Note that the control file names have changed, as have their class IDs and interfaces. This means that the new controls are not binary compatible and are not drop-in replacements for earlier versions of the control. It is recommended that you review the release notes for more information about the changes in the current version.
An application should not attempt to reference the current version of a control and an earlier version of the control within the same application. When upgrading to version 9.3, first remove all references to the earlier version of the control, save the project and reload it. Then add the reference to the 9.3 control, ensuring that the same object name is used. If you are creating an instance of the control dynamically by specifying its ProgID, such as using the CreateObject function, then it is recommended that you specify the version number as part of the ID. In other words, to create an instance of the FTP control, use "SocketTools.FtpClient.9" and not simply "SocketTools.FtpClient". If the version number is omitted, the latest version of the control will always be loaded.
The runtime license key has also changed for SocketTools 9.3, which will require you to define the new key in your application when calling the control's Initialize method. As with previous versions of SocketTools, you can use the License Manager utility to generate a file which contains the runtime key you should use. The version 8.0 and earlier runtime license keys are not valid for the version 9.3 controls and an error will be returned if an invalid runtime key is specified.
Control File Names
The file names of the ActiveX controls and their IDs have changed with the new version. The following table lists the new values which should be used in your application.
Copyright © 2018 Catalyst Development Corporation. All rights reserved.