Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SAP Sybase SQL Anywhere 16.0 » UltraLite - C and C++ Programming » Application development » UltraLite C++ application development » How to build and deploy UltraLite C++ applications

 

Deploying an UltraLite application for Windows Mobile (dynamic linkage)

This topic has been updated for build 1823.

Specify appropriate creation parameters, connection parameters, synchronization parameters, protocol options, link libraries, method calls, and deployment files to ensure that your UltraLite C++ application runs successfully on Windows and Windows Mobile devices.

Prerequisites

There are no prerequisites for this task.

 Task
  1. Specify the following parameters:

    • When using obfuscation, set the creation parameter obfuscate=1 while creating the database.

    • When using AES encryption, set the connection parameter DBKEY=encryption-key while creating or connecting to the database.

  2. Set the appropriate parameter settings when using synchronization in your UltraLite application:

    Synchronization type Parameter settings
    TCP/IP

    Set the Stream synchronization parameter to tcpip.

    HTTP

    Set the Stream synchronization parameter to http.

    RSA TLS

    Set the Stream synchronization parameter to tls.

    RSA HTTPS

    Set the Stream synchronization parameter to https.

  3. When using RSA end-to-end encryption, set the protocol option e2ee_public_key=key-file.

  4. When using ZLIB compression, set the protocol option compression=zlib.

  5. Link against the following files:

    • ulbase.lib

    • ulimp.lib

    For Windows Mobile, these files are located in %SQLANY16%\UltraLite\CE\Arm.50\Lib. For Windows, they are located in %SQLANY16%\UltraLite\Windows\x64\Lib\VS9 or %SQLANY16%\UltraLite\Windows\x86\Lib\VS9.

  6. When linking against the ulimp.lib library, define the UL_USE_DLL preprocessor macro when compiling. For example, specify the following:

    -DUL_USE_DLL
  7. Call the following methods in your UltraLite application:

    • When using AES encryption, the ULDatabaseManager.EnableAesDBEncryption method.

  8. Ensure that the following methods are called for the synchronization type used in your UltraLite application:

    Synchronization type Parameter settings
    TCP/IP

    Call the EnableTcpipSynchronization method.

    HTTP

    Call the EnableHttpSynchronization method.

    RSA TLS

    Call the EnableTlsSynchronization and EnableRsaSyncEncryption methods.

    RSA HTTPS

    Call the EnableHttpsSynchronization and EnableRsaSyncEncryption methods.

  9. Deploy the following files:

    • ulrt16.dll.

    • When using ZLIB compression, mlczlib16.dll.

    • When using RSA TLS, RSA HTTPS, or RSA E2EE, mlcrsa16.dll.

    For Windows Mobile, the files are located in %SQLANY16%\UltraLite\CE\Arm.50. For Windows, the files are located in %SQLANY16%\UltraLite\Windows\x64 or %SQLANY16%\UltraLite\Windows\x86.

Results

The UltraLite C++ application, which uses dynamic linkage, runs successfully on the Windows desktop or Windows Mobile device that it is deployed to.

Next

Deploy an UltraLite database to the Windows desktop or Windows Mobile device that the application was deployed to, or create a new database with the deployed application.

 See also