Contents Index Stream parameters reference HotSync synchronization stream parameters

UltraLite Database User's Guide
   Synchronization for UltraLite Applications
    Stream parameters reference

ActiveSync synchronization stream parameters


The ActiveSync synchronization stream is accessible only from Native UltraLite for Java, embedded SQL, and static C++ API applications running on Windows CE.

To choose ActiveSync synchronization:

Meaning of synchronization stream parameters 

The stream parameters control the connection from the MobiLink ActiveSync provider, running on the desktop machine, to the MobiLink synchronization server.

The stream parameters take the following form:

stream=stream_name;provider_stream_parameters

where stream_name indicates the protocol for the conduit to use when communicating from the conduit to the MobiLink synchronization server. It must be one of the following:

and where provider_stream_parameters is a set of stream parameters for use by the ActiveSync provider, and has the same form as the stream parameters for the protocol in use. For the given stream, the provider_stream_parameters adopts the same defaults as the stream parameters for the protocol. The default value for the stream_name is tcpip.

For example, the following static C++ code uses an HTTP synchronization stream:

ULInitSynchInfo( &info );
info.stream = ULActiveSyncStream();
info.stream_parms = "stream=http";
ULSynchronize( &sqlca, &info );

For more information on provider_stream_parameters, see TCP/IP stream parameters, HTTP stream parameters, and HTTPS stream parameters.

Adding encryption to ActiveSync synchronization 

To add Certicom encryption to the stream, the root certificates must be in a file on the desktop machine. This is different from other UltraLite applications, where the encryption information is embedded in the security synchronization parameter.

The stream parameters need to be specified in the stream parameters in much the same way as for Adaptive Server Anywhere MobiLink clients . The format is:

security=cipherkeyword=value;... }

where cipher must be certicom_tls and the keywords are taken from the following list:

For example, a static C++ application may use a line such as the following:

info.stream_parms = "stream=tcpip;security=ecc_tls(trusted_certificates=trusted.crt)";

For more information, see CREATE SYNCHRONIZATION USER statement [MobiLink].


Contents Index Stream parameters reference HotSync synchronization stream parameters