C16_SelAddLink

Mit dieser Funktion wird zu einer Selektion eine weitere Abfrage angehängt. Die Abfrage kann nur über eine Verknüpfung verbunden werden. Innerhalb einer Selektion können bis zu 16 Abfragen erstellt werden.

Als Objekt wird der Deskriptor, der von der Anweisung C16_SelCreate()zurückgegeben wurde übergeben. In aNameAnchor wird der Anker der neuen Abfrage angegeben. Hierbei handelt es sich entweder um den Namen einer anderen Abfrage oder um eine Leerstring bzw. NULL. Der Leerstring bzw. NULL entspricht dabei der ersten Abfrage der Selektion. In den Parametern aTargetFileNumber, aSourceFileNumber und aLinkNumber wird die Verknüpfung angegeben. Die Parameter entsprechen dabei der Ziel-Datei, der Quell-Datei und der Nummer der Verknüpfung. Die Quell-Datei muss dabei die Ausgangsdatei der übergeordneten Abfrage sein. Existiert in der Quell-Datei keine entsprechende Verknüpfung oder stimmt die Ziel-Datei nicht überein, kommt es zu einem Fehler.

Die Abfrage muss mit einem Namen versehen werden. Dieser Name gilt als Referenz für weitere Abfragen und zur Definition der Selektionskriterien. Der Name wird in aQueryName angegeben. Er darf maximal 16 Zeichen lang sein und muss mit einem Buchstaben beginnen. In aOptions kann die Konstante _SelResultSet angegeben werden, um das Ergebnis der angehängte Abfrage als eine Ergebnismenge anzulegen. Zuvor muss mit der Funktion ``C16_SelAddResult() die Ergebnismenge angelegt worden sein. Wird der Parameter weggelassen oder 0 übergeben, wird das Ergebnis nicht in der Ergebnismenge abgelegt.