Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - 编程 » SQL Anywhere 数据访问 API » SQL Anywhere 嵌入式 SQL » 库函数参考

 

db_locate_servers 函数

原型
unsigned intdb_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;
  • port_type   它在此时始终为 PORT_TYPE_TCP(在 sqlca.h 中定义为 6)。

  • port_num   它是此服务器正在监听的 TCP 端口号。

  • name   指向包含服务器名称的缓冲区。

  • address   指向包含服务器 IP 地址的缓冲区。

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

另请参见