action.skip

Using the Connector for Windows

Host Access for the Cloud Connector for Windows allows you to interact with host sessions in your .NET application or within Visual Basic for Applications.

The installers, API documentation, and examples are available in a ZIP file (hacloud-extras-<version>.zip) from the same download location as the Host Access for the Cloud product files. The documentation is also always available online: HACloud Connector for Windows.

Here are a few things to keep in mind as you prepare to install:

  • Two install platforms are available: a 32-bit version and a 64-bit version. Depending on which one you install, the default base install path will be C:\Program Files (x86)\Micro Focus\HACloud\Connector for Windows or C:\Program Files\Micro Focus\HACloud\Connector for Windows

  • The installation platform you choose also determines the solution platform in which you can develop. For example: If you have installed the 32-bit version of Microsoft Office® and want to use Visual Basic for Applications with the connector, then you must install the 32-bit version of the Host Access for the Cloud Connector for Windows.

  • .NET 4.6.2 or higher is required.

  • The Connector for Windows supports these authentication methods: LDAP, Kerberos, and None. Authentication is configured in the MSS Administrative Console.

  • To use the Windows connector with Kerberos:

    • You must first be authenticated to the Windows Domain.
    • Because the MSS server must be trusted for integrated authentication, the Cluster DNS URL should be added to the Intranet Zone site list in the Internet Options for the Windows Operating System. (See Microsoft documentation for instructions).
    • When connecting a client application to a session server in the cluster, the DNS endpoint must include the HACloud webclient context. For example, https://clusterdns/webclient.

Examples and connector documentation

Documentation is available to reference from your IDE. There are also samples to help you take advantage of the connector.

  1. Navigate to the install directory. In a default install, either C:\Program Files (x86)\Micro Focus\HACloud\Connector for Windows or C:\Program Files\Micro Focus\HACloud\Connector for Windows depending on your platform.

  2. In the Connector for Windows directory you will find:

    • MicroFocus.ZFE.Connector.dll - a .NET Framework assembly to reference in your C# or .NET project.

    • MicroFocus.ZFE.Connector.tlb - a Type Library to use in your COM or Visual Basic for Applications project.

    • \help - this directory contains information which will aid in using the connector.

    • \samples - this directory contains the code samples that provide a starting point for developing your own applications.

Using the connector with Microsoft Visual Studio

If you are using Microsoft Visual Studio to develop applications, keep these things in mind:

  • When using Microsoft Visual Studio with Connector for Windows, make sure your solution platform is set to either x86 or x64, depending on your installation. Because of the native components used within the Connector for Windows SDK, the Any CPU platform is not supported. Use the Configuration Manager for your Visual Studio Solution to create a platform for x86 or x64.

  • When adding a reference to the Connector for Windows library, Visual Studio may set the Copy Local reference property to True. This should be set to False so that the library and its dependencies are executed from the SDK install directory.