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

提供对 dblocate 实用程序所显示的信息的编程式访问，列出本地网络上正在监听 TCP/IP 的所有 SQL Anywhere 数据库服务器。

回调函数必须具有以下原型：

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

对于找到的每台服务器都要调用回调函数。如果回调函数返回 0，则 db_locate_servers 停止遍历服务器。

传递到回调函数的 sqlca 和 callback_user_data 是那些传递到 db_locate_servers 中的函数。第二个参数是指向 a_server_address 结构的指针。a_server_address 在 sqlca.h 中定义，其定义如下：

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

如果成功则返回 1，否则返回 0。

• 服务器枚举实用程序 (dblocate)