C16_SelStore
C16_SelStore(const vPHANDLE aDynSelHdl, const vCHAR* aSelectionName, const vINT aOptions) : vERROR
Selektion übersetzen und speichern
Details
- aDynSelHdl: Dynamic Selektion Handle
- aSelectionName: Selektion Name
- aOptions: Sperroption
- Resultat: vERROR Fehlerwert
- Siehe: Befehle der Programmierschnittstelle , C16_SelOpen()
Mit dieser Funktion wird eine prozedural erstellte Selektion gespeichert und übersetzt. In aDynSelHdl wird das von der Anweisung C16_SelCreate() zurückgegebene Handle übergeben. In aSelectionName wird der Name angegeben, unter dem die Selektion gespeichert werden soll. Der Name darf maximal 20 Zeichen lang sein. In aOptions können Sperroptionen angegeben werden, die entscheiden, ob die Selektion nach der Speicherung gesperrt ist oder nicht. Soll die Selektion anschließend durchgeführt werden, muss sie mit _SelLock gesperrt werden.
Nach dem Speichern und übersetzen der Selektion steht das Handle des Selektionsobjekts immer noch zur Verfügung. Es kann mit C16_SelConvert() in einen Selektionspuffer umgewandelt werden. Zum Schließen des Handle oder des -puffers muss C16_SelClose() ausgeführt werden. Der Rückgabewert der Funktion gibt über den Erfolg oder Fehler sowohl beim Speichern als auch bei der Übersetzung aufschluss. Bei erfolgreicher Durchführung ist der Fehlercode C16ERR_OK.