UltraLite Embedded SQL User's Guide
  Synchronization Parameters Reference
    Synchronization parameters

security_parms synchronization parameter

Function 

Sets the parameters required when using transport-layer security. This parameter must be used together with the security parameter.

For more information, see security synchronization parameter.

Usage 

The ULSecureCerticomTLSStream() and ULSecureRSATLSStream() security parameters take a string composed of the following optional parameters, supplied in an semicolon-separated string.

• certificate_company    The UltraLite application only accepts server certificates when the organization field on the certificate matches this value. By default, this field is not checked.

• certificate_unit    The UltraLite application only accepts server certificates when the organization unit field on the certificate matches this value. By default, this field is not checked.

• certificate_name    The UltraLite application only accepts server certificates when the common name field on the certificate matches this value. By default, this field is not checked.

For example:

ul_synch_info info;
...
info.stream = ULSocketStream();
info.security = ULSecureCerticomTLSStream();
info.security_parms =
     UL_TEXT( "certificate_company=Sybase" )
     UL_TEXT( ";" )
     UL_TEXT( "certificate_unit=Sales" );

The security_parms parameter is a string, and by default is null.

If you use secure synchronization, you must also use the -r command-line option on the UltraLite generator. For more information, see The UltraLite generator.