Skip to content

Using the Connector for Windows

Host Access for the Cloud Connector for Windows is a separate installation which you can find on the Micro Focus download site. Using the Connector for Windows, you can interact with host sessions in your .NET application or within Visual Basic for Applications.

The API documentation is available in your installation directory (<install dir>\sessionserver\sdk\csharp\apidocs\index.html) as well as online here: 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.

  • API documentation is available here: <install dir>\sessionserver\sdk\csharp\apidocs\index.html

  • .NET 4.5.2 is required.

  • The Connector for Windows supports two authentication methods: LDAP and None. Authentication is configured in the MSS Admininstrative Console.

Examples and connector documentation

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

  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.