Using Verastream SDK with Visual C++

Before Verastream SDK can be used with a Visual C++ project, you must expand the Include path to include VSDKDefs.h from the SDK include directory (one time only), and you must add the Type Library Files (.tlb) to each project that you are using with the SDK. Once completed, the Verastream SDK COM classes are accessible within that project. A simple test project is recommended to ensure full functionality before project development.

Attachmate Verastream SDK for Unisys and Airlines objects require Visual C++ 2010 or later. Using SDK objects in Visual C++ applications requires a fundamental knowledge of the COM architecture.

COM and .NET applications developed with the Verastream SDK do not support the 64-bit JRE . For these applications, use the 32-bit JRE. Running a COM or .NET application using the 64-bit JRE causes COM automation error 80131534, as displayed in the following message:

Run-time error '-2146233036(80131534)'
The type initializer for 'SessionLoader.SessionLoader' threw an exception.

Using the SDK with Microsoft Foundation Classes (MFC)

To create objects, you must first initialize for COM operations using CoInitialize or CoInitializeEx. (CoInitializeEx is required if you will be using events—for more information, see Handling Events).

Alternatively, if you use Microsoft Foundation Classes (MFC), you can use the AfxOleInit function.
After receiving an interface pointer from an SDK method, it is the caller's responsibility to Release() any non-zero pointer when finished with it. Checking returned pointers for NULL values before using them is also highly recommended. This is particularly important since many properties do not consider it an error condition to return a NULL interface pointer indicating that the property is "empty."
After receiving a BSTR pointer from an SDK method, it is the caller's responsibility to use ::SysFreeString() or equivalent when finished, to free the string memory.

To add VSDKDefs.h to your Include path:
From the Tools menu, select Options. Select Directories to add the SDK include directory to your Include path.

To include the Verastream SDK COM objects in Visual C++:

Create a new MFC project, or open an existing project.
From the View menu, select ClassWizard.
On the Message Map tab of the MFC ClassWizard dialog box, click Add Class, and then select From A Type Library.
On the Import From Type Library dialog box, browse to the SDK include directory (<Installation Location>\include).
Select SessionLoader.tlb, and then click Open.
On the Confirm Classes dialog box, click OK to confirm the selected object.
Repeat this procedure to import Mutable.tlb and ScreenUPG.tlb¹.
The selected objects appear on the ClassView tab.

If you want to use the SendStatus, RawDataTransmitBytes, and getCapturedBytes methods, you must use the following files that are included with the MFC Events sample application (<Installation Location>\Program Files (x86)\Attachmate\VerastreamSDK\samples\MFC):
- iscreenupg.h
- iscreenupg.cpp
These methods are not properly imported with the Class Wizard. For more information about importing files with the Class Wizard, see http://support.microsoft.com/kb/241862.

The sample application MFC Events illustrates how to use the SDK with Visual C++.


	Development Tools Supported
	Sample Applications Overview