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

SQL Anywhere 11.0.1 (Deutsch) » SQL Anywhere Server - Programmierung » SQL Anywhere Datenzugriff-APIs » SQL Anywhere Embedded SQL » Referenz der Bibliotheksfunktionen

 

db_locate_servers-Funktion

Prototyp
unsigned intdb_locate_servers(
SQLCA * sqlca,
SQL_CALLBACK_PARM callback_address,
void * callback_user_data );
Beschreibung

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;
  • port_type   Ist hier immer PORT_TYPE_TCP (laut Definition 6 in sqlca.h)

  • port_num   Ist die TCP-Portnummer, die der Server abhört

  • name   Zeigt auf einen Puffer, der den Servernamen enthält

  • address   Zeigt auf einen Puffer, der die IP-Adresse des Servers enthält

Gibt 1 zurück, wenn erfolgreich, andernfalls 0.

Siehe auch