Zum Hauptinhalt springen

C16_SelDefQuery

C16_SelDefQuery(const vPHANDLE aInstHdl, const vCHAR aNameAnchor, const vCHAR* aQuery, const vCHAR* aProcName (opt.)) : vERROR​

Abfrage Definition für eine mit C16_SelCreate neu angelegten Selektion definieren.

Details

  • aDynSelHdl: Selektion Handle
  • aNameAnchor: Anker
  • aQuery: Zeichenkette mit der Abfrage-Bedingung
  • aProcName: (optional) Name der Prozedur/Funktion zur Anwendung auf selektierte Datensätze.
  • Resultat: vERROR Fehlerwert
  • Siehe: Befehle der Programmierschnittstelle , C16_SelCreate()

Mit dieser Funktion wird innerhalb einer neu angelegten Selektion eine Abfrage definiert. Als aDynSelHdl muss ein von C16_SelCreate() erstelltes Handle übergeben werden.

Mit aNameAnchor wird der Name eines Ankers angegeben. Der Anker wird benötigt, wenn die Abfrage einer Verknüpfung zugeordnet werden soll, die zuvor mit C16_SelAddLink () in der Selektion erzeugt wurde. Als Anker muss der dort angegebene Name der Abfrage übergeben werden.

Mit aQuery wird eine Zeichenkette mit der Abfrage-Bedingung übergeben. Die Zeichenkette muss einen logischen Ausdruck enthalten. Informationen zu logischen Ausdrücken befinden sich im Abschnitt "Logische Ausdrücke in dynamischen Selektionen". Enthält die Abfrage ein Vorauswahl auf einen Schlüssel, bei dem ein Schlüsselfeld SOUNDEX 1 oder SOUNDEX 2 aktiviert hat, liefert die Funktion den Fehlerwert C16ERR_SEL_INVALID_KEY.

In aProcName kann eine Prozedur oder Funktion angegeben werden, die für alle Datensätze, die das Abfragekriterium erfüllen durchgeführt wird. Der Rückgabewert der Prozedur bestimmt, ob der Datensatz in die Selektionsmenge aufgenommen wird (true) oder nicht (false). Über den Rückgabewert kann überprüft werden, ob die Anweisung korrekt ausgeführt werden konnte (C16ERR_OK) oder nicht (Fehlercode &lt 0).