SQLMORERESULTS( )-Funktion

Kopiert ein weiteres Resultset in einen Visual FoxPro-Cursor, wenn mehrere Resultsets verfügbar sind.

SQLMORERESULTS(nConnectionHandle)

Rückgabewerte

Numerisch

Parameter

• nConnectionHandle
  Gibt das Verbindungshandle der Datenquelle an, das von SQLCONNECT( ) zurückgegeben wird.

Hinweise

SQLMORERESULTS( ) ermittelt, ob eine SQL-Anweisung, die mit SQLEXEC( ) im Nicht-Batchmodus ausgeführt wurde, mehrere Resultsets bereitstellt. Wenn mehrere Resultsets zur Verfügung stehen, werden diese nacheinander in einen Visual FoxPro-Cursor kopiert.

SQLMORERESULTS( ) gibt 0 zurück, wenn die SQL-Anweisung noch ausgeführt wird, 1 wird zurückgegeben, wenn die Ausführung abgeschlossen ist, und 2, wenn keine Daten mehr gefunden werden. Im Nicht-Batchmodus sollte SQLMORERESULTS( ) nach jedem erfolgreichen Aufrufen von SQLEXEC( ) aufgerufen werden, bis SQLMORERESULTS( ) 2 zurückgibt (keine Daten mehr gefunden). Der Wert der BatchMode-Einstellung von SQLSETPROP( ) legt fest, ob SQLEXEC( ) eine SQL-Anweisung im Batchmodus oder im Nicht-Batchmodus ausführt.

SQLMORERESULTS( ) gibt -1 zurück, wenn ein Fehler auf Verbindungsebene aufgetreten ist, und -2 bei einem Fehler auf Umgebungsebene.

SQLMORERESULTS( ) gehört zu den vier Funktionen, die Sie entweder synchron oder asynchron ausführen können. Die asynchrone Einstellung von SQLSETPROP( ) legt fest, ob diese Funktionen synchron oder asynchron ausgeführt werden. Im Asynchronmodus müssen Sie SQLMORERESULTS( ) wiederholt aufrufen, bis ein anderer Wert als 0 (wird noch ausgeführt) zurückgegeben wird.

Beispiel

Im folgenden Beispiel wird davon ausgegangen, dass SQLCONNECT( ) erfolgreich ausgeführt und der entsprechende Rückgabewert in der Speichervariablen gnConnHandle gespeichert wird. Die BatchMode-Eigenschaft wird mit SQLSETPROP( ) auf Falsch (.F.) gesetzt. Dann können die einzelnen Resultsets abgerufen werden.

SQLMORERESULTS( ) wird zweimal angegeben, um zwei Cursor zu erstellen, die die Ergebnisse der SQLEXEC( )-Abfrage enthalten. Das Umgebungsfenster und die von SQLEXEC( ) erstellten Cursor werden mit SET angezeigt.

= SQLSETPROP(gnConnHandle, 'BatchMode', .F.)  && Individual result sets
= SQLEXEC(gnConnHandle, 'SELECT * FROM authors;
   SELECT * FROM titles')
= SQLMORERESULTS(gnConnHandle)  && First result set
= SQLMORERESULTS(gnConnHandle)  && Second result set

Siehe auch

AERROR( ) | SQLCANCEL( ) | SQLCONNECT( ) | SQLEXEC( ) | SQLGETPROP( ) | SQLSETPROP( )