ASA Programming Guide
The Database Tools Interface
DBTools structures
Holds the information needed to extract a collation sequence from a database using the DBTools library.
typedef struct a_db_collation {
unsigned short version;
const char * connectparms;
const char * startline;
const char * collation_label;
const char * filename;
MSG_CALLBACK confirmrtn;
MSG_CALLBACK errorrtn;
MSG_CALLBACK msgrtn;
a_bit_field include_empty : 1;
a_bit_field hex_for_extended : 1;
a_bit_field replace : 1;
a_bit_field quiet : 1;
const char * input_filename;
const char _fd_ * mapping_filename;
} a_db_collation;
| Member | Description |
|---|---|
| version | DBTools version number |
| connectparms |
The parameters needed to connect to the database. They take the form of connection strings, such as the following:
"UID=DBA;PWD=SQL;DBF=c:\asa\asademo.db"For the full range of connection string options, see Connection parameters |
| startline |
The command-line used to start the database engine. The following is an example start line:
"c:\asa\win32\dbeng9.exe"The default start line is used if this member is NULL |
| confirmrtn | Callback routine for confirming an action |
| errorrtn | Callback routine for handling an error message |
| msgrtn | Callback routine for handling an information message |
| include_empty | Write empty mappings for gaps in the collations sequence |
| hex_for_extended | Use two-digit hexadecimal numbers to represent high-value characters |
| replace | Operate without confirming actions |
| quiet | Operate without messages |
| input_filename | Input collation definition |
| mapping_filename | syscollationmapping output |
For more information on callback functions, see Using callback functions.