Partager via

Creating a Common Container for a Custom Transport

  • Article

Custom Kitl AppWizard (CustomKitl.awx) is a template for Microsoft Visual C++ 6.0 or later. CustomKitl.awx creates a common container for any custom KITL transport. The common container is a Component Object Model (COM) dynamic-link library (DLL) for the transport. Platform Manager recognizes this COM DLL.

You can find the CustomKitl.awx file in the Sdk\Wce420\Wizards directory in the top-level directory for Platform Manager. To use the template, copy the CustomKitl.awx file to the Microsoft Visual Studio\Common\MSDev98\Bin\IDE directory. You can then run Visual C++ and use the template.

To create a common container for a custom KITL transport

  1. Install Visual C++ 6.0 or later, and then run Visual C++.

  2. From the File menu, choose New.

  3. Choose the Projects tab.

  4. In the list, choose Custom Kitl AppWizard.

  5. In the Project name box, type a name for the project.

  6. In the Location box, type the path for the project.

    Be sure the directory you enter in the Location box does not already exist.

  7. Choose OK.

  8. In the Kernel transport library box, type the name of the transport library that your custom transport uses.

    If your transport uses the KITL Ethernet library, type EthTran.dll. If your transport uses the KITL Serial library, type SerTran.dll. If your transport uses a custom transport library, type the name of the custom library.

  9. In the Property GUID box, type the globally unique identifier (GUID) for the location where the transport properties are stored.

    You may choose any unique GUID.

  10. In the Kernel transport name box, type a name for your transport in the exact format you want the name to appear in the Configure Remote Connection dialog box in Platform Builder.

    To view the Configure Remote Connection dialog box, choose Configure Remote Connection from the Target menu in Platform Builder.

  11. In the Additional Project Include Paths box, enter the paths for the Cemgr.h, Kitl.h, KitlClnt.h, KitlTran.h, and Kitldll.lib files.

    The Cemgr.h, Kitl.h, KitlClnt.h, and KitlTran.h files are located in the Sdk\Wce420\Platman\Include directory in the top-level Platman directory for Platform Manager. The Kitldll.lib file is located in the Sdk\Wce420\Platman\Lib\Dsktop directory in the top-level Platman directory.

  12. Choose OK.

  13. Compile your project for a debug or release build.

  14. Copy the KITL engine (Kitldll.dll) to the Debug or Release directory in the directory you typed in the Location box.

    The Kitldll.dll file is located in the Bin directory in the top-level Platman directory for Platform Manager.

  15. If your transport uses a custom transport library, copy the library to the Debug or Release directory in the directory you typed in the Location box.

See Also

Addition of a Custom Transport to the Configure Remote Connection Dialog Box

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.