ActiveSync protocol options

Guidance:

Ultralite synchronization Parameters

Network protocol options of the ultralite synchronization Client

ActiveSync protocol options

ActiveSync synchronization streams can only be accessed by running native ultralite for Java, embedded SQL, and static C ++ API applications on Windows CE.

Select ActiveSync synchronization:

• In Native ultralite for Java, streamtype. active_sync is provided to syncparms. setstream as a parameter. For example:

  _conn.syncParms.setStream( StreamType.ACTIVE_SYNC );

  For more information, seeIanywhere. native_ultralite.streamtypeAndIanywhere. native_ultralite.syncparms.

• In Embedded SQL and static C ++ APIs, ulactivesyncstream () is provided as the network protocol. For example:

  ul_synch_info info;
  ...
  info.stream = ULActiveSyncStream();

  For more information, see the ulactivesyncstream function.

Meaning of protocol options

Protocol options allow you to control the connection from the MobiLink ActiveSync provider running on a desktop computer to the MobiLink synchronization server.

Protocol options take the following form:

stream=stream_name;provider_stream_parameters

Where,Stream_nameIndicates the protocol used by the pipeline when the pipeline communicates with the MobiLink synchronization server. It must be one of the following values:

• Tcpip

• HTTP

• HTTPS

Provider_stream_parametersIs a set of protocol options for the ActiveSync provider, in the same form as the protocol options for the protocol being used. For a given protocol,Provider_stream_parametersThe default value is the same as the default value of the protocol option.Stream_nameThe default value isTcpip.

For example, the following static C ++ Code uses the HTTP protocol:

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

RelatedProvider_stream_parametersFor more information, see TCP/IP protocol options, HTTP protocol options, and HTTPS protocol options.

Add encryption for ActiveSync Synchronization

To add certicom encryption to a stream, the root certificate must be in a file on the desktop computer. This is equivalent to embedding encrypted informationSecurityThe other ultralite applications in the synchronization parameters are different.

The protocol options must be specified in the same way as the Adaptive Server Anywhere MobiLink client. The format is as follows:

Security =Cipher{Keyword=Value;...}

WhereCipherIt must be certicom_tls and the keyword must use the values in the following list:

• Certificate_companyThe unit name field on the certificate.

• Certificate_unitName field of the Organization and department on the certificate.

• Certificate_nameThe public name segment on the certificate.

• Trusted_certificatesThe location of the trusted certificate.

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

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

For more information, see:

• Certificate_company
  
• Certificate_name
  
• Certificate_unit
  
• Trusted_certificates

This article is transferred from
Http://www.ianywhere.com/developer/product_manuals/sqlanywhere/0902/zh/html/dbmnzh9/00000334.htm