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)

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.

Prérequis

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, or FIPS 140-2 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.

    RSA FIPS 140-2 TLS

    Set the Stream synchronization parameter to tls.

    Set the protocol option fips=yes.

    RSA FIPS 140-2 HTTPS

    Set the Stream synchronization parameter to https.

    Set the protocol option fips=yes.

  3. When using RSA or RSA FIPS 140-2 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.

    • When using FIPS 140-2 AES encryption, the ULDatabaseManager.EnableAesFipsDBEncryption 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.

    RSA FIPS 140-2 TLS

    Call the EnableTlsSynchronization and EnableRsaFipsEncryption methods.

    RSA FIPS 140-2 HTTPS

    Call the EnableHttpsSynchronization and EnableRsaFipsSyncEncryption 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.

    • When using FIPS 140-2 AES encryption, ulfips16.dll and sbgse2.dll.

    • When using RSA FIPS 140-2 TLS or RSA FIPS 140-2 HTTPS synchronization, sbgse2.dll and mlcrsafips16.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.

Résultat

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

Suivant

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