asqlhandles
asqlhandles(ToArray AS Any@, [SqlHandleOrigin AS Integer]) AS Integer
Liefert eine Liste aller Handles einer ODBC-Verbindung.
Parameter ToArray
Eine per Referenz übergebene Variable, in der eine Liste aller
SqlHandles abgelegt wird. Das Array wird automatisch auf die
notwendige Größe angepasst.
Parameter SqlHandleOrigin
Gibt nur SqlHandles aus, die zu derselben Datenbankverbindung
gehören, wie die Datenbankverbindung des SqlHandles SqlHandleOrigin.
Dabei ist es unerheblich, ob SqlHandleOrigin das erste Handle ist,
das mit der sqlconnect-Funktion erstellt wurde, oder ob es sich dabei
um einen Ableger handelt.
Rückgabewert
Anzahl der ermittelten SqlHandles.
1
2
3
4
5
6
7
8
LOCAL handles[1], anzahlHandles, i
anzahlHandles = asqlhandles(handles)
? "anzahlHandles: ", anzahlHandles
FOR i=1 to anzahlHandles
sqldisconnect(handles[i])
ENDFOR
Das folgende Beispiel zeigt die Verwendung von asqlhandles in
Zusammenhang mit einem speziellen Ursprung.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
LOCAL origin_conn, stmt1, stmt2
origin_conn = sqlconnect("odbc_datasource_name")
stmt1= sqlconnect(origin_conn)
sqlprepare(stmt1, "select * from sometable where primkey=1")
stmt2= sqlconnect(origin_conn)
sqlprepare(stmt2, "select * from someothertable where primkey=1")
LOCAL handles[1], anzahlHandles, i
anzahlHandles= asqlhandles(handles, origin_conn)
ASSERT anzahlHandles == 2
FOR i = 1 to anzahlHandles
sqldisconnect(handles[i])
ENDFOR