UltraLite User's Guide
UltraLite Reference
Synchronization stream parameters
To choose HotSync synchronization, supply the ul_synch_info structure to the ULPalmExit or ULData::PalmExit method of your application. The stream parameter is ignored, and may be set to UL_NULL.
For more information on choosing a HotSync synchronization stream, see Understanding HotSync synchronization.
For HotSync synchronization, the stream_parms values do not control the connection from the device to the HotSync Manager or HotSync Server. Instead, they specify the connection from the MobiLink conduit, running at the HotSync manager or server, to the MobiLink synchronization server.
The stream_parms argument has the following form:
stream=stream_name;conduit_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:
tcpip
http
and where conduit_stream_parameters is a set of stream parameters for use by the conduit, and has the same form as the stream_parms argument for the protocol in use. For the given stream, the conduit_stream_parameters adopts the same defaults as the stream_parms argument for the protocol. The default value for the stream_name is tcpip.
For example, the following snippet uses an HTTP synchronization stream:
ULInitSynchInfo( &info ); info.stream_parms = "stream=http";
For more information on conduit_stream_parameters, see TCP/IP stream parameters, and HTTP stream parameters.
If you use HotSync synchronization, and supply a null value to stream_parms, the conduit searches in the registry for the stream name and stream parameters. If it finds no valid stream, the default stream and stream parameters is used. This default stream_parms parameter is:
stream=tcpip;host=localhost
For information on registry locations, see Configuring conduit 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=cipher( keyword=value;... )
where cipher must be ecc_tls and the keywords are taken from the following list:
certificate_company The organization field on the certificate.
certificate_unit The organization unit field on the certificate.
certificate_name The common name field on the certificate.
trusted_certificates The location of the trusted certificates.
For example:
info.stream_parms = "stream=tcpip;security=ecc_tls(trusted_certificates=trusted.crt)";
For more information, see CREATE SYNCHRONIZATION USER statement [MobiLink].