unsigned int db_locate_servers(
SQLCA * sqlca,
SQL_CALLBACK_PARM callback_address,
void * callback_user_data );

1, wenn erfolgreich, sonst 0.

Bietet Zugriff auf die vom Befehlszeilen-Dienstprogramm dblocate angezeigten Daten und listet alle SQL Anywhere-Datenbankserver mit TCP/IP-Anschluss im lokalen Netzwerk auf.

Die Callback-Funktion muss folgende Syntax haben:

int (*)( SQLCA * sqlca,
a_server_address * server_addr,
void * callback_user_data );

Die Callback-Funktion wird für jeden gefundenen Server ausgeführt. Wenn die Callback-Funktion den Wert 0 zurückgibt, stoppt db_locate_servers die Suche nach Servern.

Die an die Callback-Funktion übergebenen Parameter sqlca und callback_user_data sind dieselben, die an db_locate_servers übergeben wurden. Der zweite Parameter ist ein Zeiger auf eine a_server_address-Struktur. a_server_address wird mit folgender Definition in sqlca.h festgelegt:

typedef struct a_server_address {
    a_sql_uint32 port_type;
    a_sql_uint32 port_num;
    char         *name;
    char         *address;
} a_server_address;

• SQL-Kommunikationsbereich (SQLCA)
• Dienstprogramm für die Serverauflistung (dblocate)