UltraLite User's Guide
UltraLite Reference
Synchronization parameters
Set the MobiLink synchronization stream to use for synchronization.
Most synchronization streams require parameters to identify the MobiLink synchronization server address and other behavior. These parameters are supplied in the stream_parms parameter.
For more information, see stream_parms synchronization parameter.
The parameter has no default value, and must be explicitly set.
For embedded SQL, set the parameter as in the following example:
ul_synch_info info; ... info.stream = ULSocketStream();
C++ API usage is as follows:
Connection conn; auto ul_synch_info info; ... conn.InitSynchInfo( &info ); info.stream = ULSocketStream();
When the type of stream requires a parameter, pass that parameter using the stream_parms parameter; otherwise, set the stream_parms parameter to null.
The following C/C++ stream functions are available, but may not be supported on all target platforms:
| Stream | Description |
|---|---|
| ULActiveSyncStream() |
ActiveSync synchronization (Windows CE only).
For a list of stream parameters, see ActiveSync parameters. |
| ULConduitStream() |
Synchronize via HotSync stream (C/C++ only, Palm Computing Platform only).
This function is deprecated. You can supply UL_NULL to synchronize via HotSync. For a list of stream parameters, see HotSync parameters. |
| ULHTTPStream() |
Synchronize via HTTP.
The HTTP stream uses TCP/IP as its underlying transport. UltraLite applications act as Web browsers and the MobiLink synchronization server acts as a Web server. UltraLite applications send POST requests to send data to the server and GET requests to read data from the server. For a list of stream parameters, see HTTP stream parameters. |
| ULHTTPSStream() |
Synchronize via the HTTPS synchronization stream.
The HTTPS stream uses SSL or TLS as its underlying protocol. It operates over Internet protocols (HTTP and TCP/IP). The HTTPS stream requires the use of technology supplied by Certicom. Use of Certicom technology requires that you obtain the separately-licensable SQL Anywhere Studio security option and is subject to export regulations. For more information on this option, see Welcome to SQL Anywhere Studio. For a list of stream parameters, see HTTPS stream parameters. |
| ULPalmDBStream() |
Synchronize via HotSync stream (C/C++ only, Palm Computing Platform only).
This function is deprecated. You can supply UL_NULL to synchronize via HotSync. For a list of stream parameters, see HotSync parameters. |
| ULSocketStream() |
Synchronize via TCP/IP.
For a list of stream parameters, see TCP/IP stream parameters. |
The Java access methods are getStream and setStream. The stream itself is an object, and the stream names differ slightly from the C/C++ versions.
| Stream | Description |
|---|---|
| UlHTTPStream() |
HTTP synchronization.
For a list of stream parameters, see HTTP stream parameters. |
| UlHTTPSStream() |
HTTPS synchronization.
For a list of stream parameters, see HTTPS stream parameters. |
| UlSecureSocketStream() |
TCP/IP or HTTP synchronization with transport-layer security using elliptic curve encryption.
For a list of stream parameters, see UlSecureSocketStream synchronization parameters. |
| UlSecureRSASocketStream() |
TCP/IP or HTTP synchronization with transport-layer security using RSA encryption.
For a list of stream parameters, see UlSecureRSASocketStream synchronization parameters.. |
| UlSocketStream() |
TCP/IP synchronization.
For a list of stream parameters, see TCP/IP stream parameters. |
Set the parameter as follows:
UlSynchOptions opts = new UlSynchOptions; opts.setStream(new UlSocketStream() ); opts.setStreamParms( "host=myserver;port=2439" ); // set other options here conn.synchronize( opts );
For information on Java synchronization streams, see Initializing the synchronization options.