UltraLite User's Guide
  UltraLite Reference
    Synchronization stream parameters

ActiveSync parameters

The ActiveSync synchronization stream is accessible from C/C++ applications running on Windows CE.

Meaning of synchronization stream parameters 

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

The stream_parms argument has 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:

• tcpip

• http

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_parms argument for the protocol in use. For the given stream, the provider_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 = ULActiveSyncStream();
info.stream_parms = "stream=http";
ULSynchronize( &sqlca, &info );

For more information on provider_stream_parameters, see TCP/IP stream parameters, and HTTP 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=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].