df_lists.h-Dateireferenz

#include "df_defines.h"

gehe zum Quellcode dieser Datei

Funktionen
DF_API_EXTERN int DF_API_CALL	DFCTableOpen (int connectionNumber, int deviceAddress, const char *name, int options, int *tableHandle)
	Öffnet eine vorhandene Tabelle (Liste) zur Bearbeitung.
DF_API_EXTERN int DF_API_CALL	DFCTableClose (int connectionNumber, int deviceAddress, int tableHandle)
	Schließt eine geöffnete Tabelle.
DF_API_EXTERN int DF_API_CALL	DFCTableSetFilter (int connectionNumber, int deviceAddress, int tableHandle, const char *value)
	Setzen eines Datenfilters auf die Tabelle.
DF_API_EXTERN int DF_API_CALL	DFCTableGetFilter (int connectionNumber, int deviceAddress, int tableHandle, char *value, int *valueSize)
	Lesen des Datenfilters der Tabelle.
DF_API_EXTERN int DF_API_CALL	DFCTableRemoveFilter (int connectionNumber, int deviceAddress, int tableHandle)
	Entfernen eines gesetzten Datenfilters von der Tabelle.
DF_API_EXTERN int DF_API_CALL	DFCTableGetRowCount (int connectionNumber, int deviceAddress, int tableHandle, int *currentCount, int *unsortedCount, int *deletedCount)
	Ermittlung der aktuellen Datensatzanzahl.
DF_API_EXTERN int DF_API_CALL	DFCTableGetCurrentRow (int connectionNumber, int deviceAddress, int tableHandle, int *currentRow)
	Ermittelt die aktuelle Zeilennummer.
DF_API_EXTERN int DF_API_CALL	DFCTableSetCurrentRow (int connectionNumber, int deviceAddress, int tableHandle, int offset, int direction)
	Setzen der aktuellen Zeilennummer.
DF_API_EXTERN int DF_API_CALL	DFCTableSetCurrentRowData (int connectionNumber, int deviceAddress, int tableHandle, int flags, char separator, const char *data, int dataSize)
	Überschreibt die aktuelle Datenzeile mit den angegeben Daten.
DF_API_EXTERN int DF_API_CALL	DFCTableSetCurrentColumnData (int connectionNumber, int deviceAddress, int tableHandle, int flags, const char *name, const char *data, int dataSize)
	Überschreiben eines Feldwertes.
DF_API_EXTERN int DF_API_CALL	DFCTableGetCurrentRowData (int connectionNumber, int deviceAddress, int tableHandle, int flags, char separator, char *data, int *dataSize)
	Liest die aktuelle Datenzeile.
DF_API_EXTERN int DF_API_CALL	DFCTableGetCurrentColumnData (int connectionNumber, int deviceAddress, int tableHandle, int flags, const char *name, char *data, int *dataSize)
	Lesen eines Feldwertes.
DF_API_EXTERN int DF_API_CALL	DFCTableSetAllRowsToColumnData (int connectionNumber, int deviceAddress, int tableHandle, int flags, const char *name, const char *data, int dataSize)
	Überschreiben einer Spalte der gesamten dem aktuellen Filterkriterium entsprechenden Datenzeilen.
DF_API_EXTERN int DF_API_CALL	DFCTableAppendRowData (int connectionNumber, int deviceAddress, int tableHandle, int flags, char separator, const char *data, int dataSize)
	Anfügen einer neuen Datenzeile.
DF_API_EXTERN int DF_API_CALL	DFCTableDeleteCurrentRow (int connectionNumber, int deviceAddress, int tableHandle, int flags)
	Aktuelle Datenzeile als gelöscht markieren.
DF_API_EXTERN int DF_API_CALL	DFCTableDeleteAvailableRows (int connectionNumber, int deviceAddress, int tableHandle, int flags)
	Markiert alle dem Filterkriterium enstsprechenden Datenzeilen als gelöscht.

Dokumentation der Funktionen

DFCTableAppendRowData()

DF_API_EXTERN int DF_API_CALL DFCTableAppendRowData	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags,
		char	separator,
		const char *	data,
		int	dataSize
	)

Anfügen einer neuen Datenzeile.

Der Tabelle wird die angegebene Datenzeile angefügt.

Export

DFComDLL als DFCTableAppendRowData
DFCom_x64 als DFCTableAppendRowData

Zu beachten

• Handelt es sich bei der Tabelle um eine Liste mit Sortiertspalte, wird die Datenzeile als unsortierte Datenzeile angefügt. Bei zu vielen unsortierten Datenzeilen wird die Datensuche verlangsamt, deswegen sollten Tabellen mit zu vielen unsortierten Datenzeilen komplett übertragen werden. Mit DFCTableGetRowCount() kann unter anderen auch die Anzahl unsortiert hinzugefügter Datenzeilen ermittelt werden.
• Die durch diese Funktion angefügten Datenzeilen werden bei einer Auswahl über die Setup-Feldfunktion "Aus Liste auswählen" unsortiert angezeigt und sind somit die zuletzt angezeigten Datenzeilen.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung ... Nicht verwendet. Bitte immer 0 übergeben.
[in]	separator	Angabe der in data enthaltenen Datenfelder. Wert Bedeutung 0 Die Feldwerte sind als Zeichenarray im Binärformat angegeben. 9 Sie sind durch einen Tabulator '\t' voneinander getrennt. 59 Sie sind durch ein Semikolon ';' voneinander getrennt.
[in]	data	Datenarray.
[in]	dataSize	Länge des Datenarrays.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableClose()

DF_API_EXTERN int DF_API_CALL DFCTableClose	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle
	)

Schließt eine geöffnete Tabelle.

Schließt eine zuvor mit DFCTableOpen() geöffnete Tabelle.

Export

DFComDLL als DFCTableClose
DFCom_x64 als DFCTableClose

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableDeleteAvailableRows()

DF_API_EXTERN int DF_API_CALL DFCTableDeleteAvailableRows	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags
	)

Markiert alle dem Filterkriterium enstsprechenden Datenzeilen als gelöscht.

Durch einen folgenden Aufruf von DFCTableRemoveFilter() muss ein ggf. gesetzter Filter gelöscht werden. Wurde die Liste mit dem Flag für "Gesamte Liste" gelöscht, dann steht die Liste als Leere Liste zur Verfügung und kann mittels DFCTableAppendRowData() gefüllt werden. Sie muss mit DFCTableClose() geschlossen werden.

Export

DFComDLL als DFCTableDeleteAvailableRows
DFCom_x64 als DFCTableDeleteAvailableRows

Zu beachten

Bei zu vielen als gelöscht markierten Datenzeilen wird unnötig Speicher belegt, deswegen sollten Tabellen mit zu vielen gelöschten Datenzeilen komplett übertragen werden. Mit DFCTableGetRowCount() kann unter anderen auch die Anzahl gelöschter Datenzeilen ermittelt werden.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung 1 1 Alle Listenzeilen löschen. Ansonsten werden nur dem Filterkriterium entsprechende Datenzeilen gelöscht. ... Nicht verwendet. Bitte immer 0 übergeben.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableDeleteCurrentRow()

DF_API_EXTERN int DF_API_CALL DFCTableDeleteCurrentRow	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags
	)

Aktuelle Datenzeile als gelöscht markieren.

Die aktuelle Datenzeile wird als gelöscht markiert und ein weiterer Zugriff ist nicht möglich.

Export

DFComDLL als DFCTableDeleteCurrentRow
DFCom_x64 als DFCTableDeleteCurrentRow

Zu beachten

Bei zu vielen als gelöscht markierten Datenzeilen wird unnötig Speicher belegt, deswegen sollten Tabellen mit zu vielen gelöschten Datenzeilen komplett übertragen werden. Mit DFCTableGetRowCount() kann unter anderen auch die Anzahl gelöschter Datenzeilen ermittelt werden.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung 1 1 Nach der Ausführung wird auf die nächste Datenzeile gewechselt. Dieses erspart ein folgender Aufruf von DFCTableSetCurrentRow(). ... Nicht verwendet. Bitte immer 0 übergeben.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableGetCurrentColumnData()

DF_API_EXTERN int DF_API_CALL DFCTableGetCurrentColumnData	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags,
		const char *	name,
		char *	data,
		int *	dataSize
	)

Lesen eines Feldwertes.

Liest aus der aktuellen Datenzeile den angegebenen Feldwert.

Export

DFComDLL als DFCTableGetCurrentColumnData
DFCom_x64 als DFCTableGetCurrentColumnData

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung 1 1 Nach der Ausführung wird auf die nächste Datenzeile gewechselt. Dieses erspart ein folgender Aufruf von DFCTableSetCurrentRow(). ... Nicht verwendet. Bitte immer 0 übergeben.
[in]	name	Feldname.
[in]	data	Datenarray.
[in,out]	dataSize	Als in die Länge des Datenarrays von data, als out die Anzahl übergebener Daten.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableGetCurrentRow()

DF_API_EXTERN int DF_API_CALL DFCTableGetCurrentRow	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int *	currentRow
	)

Ermittelt die aktuelle Zeilennummer.

Ermittelt die Zeilennummer auf der aktuell der Satzzeiger steht.

Export

DFComDLL als DFCTableGetCurrentRow
DFCom_x64 als DFCTableGetCurrentRow

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[out]	currentRow	Aktuelle Zeilennummer.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableGetCurrentRowData()

DF_API_EXTERN int DF_API_CALL DFCTableGetCurrentRowData	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags,
		char	separator,
		char *	data,
		int *	dataSize
	)

Liest die aktuelle Datenzeile.

Die aktuelle Datenzeile wird in gelesen.

Export

DFComDLL als DFCTableGetCurrentRowData
DFCom_x64 als DFCTableGetCurrentRowData

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung 1 1 Nach der Ausführung wird auf die nächste Datenzeile gewechselt. Dieses erspart ein folgender Aufruf von DFCTableSetCurrentRow(). ... Nicht verwendet. Bitte immer 0 übergeben.
[in]	separator	Angabe der in data enthaltenen Datenfelder. Wert Bedeutung 0 Die Feldwerte sind als Zeichenarray im Binärformat angegeben. 9 Sie sind durch einen Tabulator '\t' voneinander getrennt. 59 Sie sind durch ein Semikolon ';' voneinander getrennt.
[in]	data	Datenarray.
[in,out]	dataSize	Als in die Länge des Datenarrays von data, als out die Anzahl übergebener Daten.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableGetFilter()

DF_API_EXTERN int DF_API_CALL DFCTableGetFilter	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		char *	value,
		int *	valueSize
	)

Lesen des Datenfilters der Tabelle.

Wurde ein Datenfilter auf die Tabelle gesetzt wird dieser durch Aufruf gelesen.

Export

DFComDLL als DFCTableGetFilter
DFCom_x64 als DFCTableGetFilter

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	value	Zeichenarray für den Filterwert.
[in]	valueSize	Als in die Länge des Zeichenarrays von value, als out die übergebene Anzahl Zeichen.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableGetRowCount()

DF_API_EXTERN int DF_API_CALL DFCTableGetRowCount	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int *	currentCount,
		int *	unsortedCount,
		int *	deletedCount
	)

Ermittlung der aktuellen Datensatzanzahl.

Es wird zwischen Gesamtanzahl, unsortiert angefügter und als gelöscht markierter Datenzeilen unterschieden.

Export

DFComDLL als DFCTableGetRowCount
DFCom_x64 als DFCTableGetRowCount

Zu beachten

Wenn die Anzahl für unsortedCount oder auch deletedCount eine gewisse Größe erreichen, sollten Sie die komplette Liste neu übertragen. Da durch zu viele unsortierte Datenzeilen eine Datensuche verlangsamt wird und die als gelöscht markierte Datenzeilen unnötigen Speicher benötigen.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[out]	currentCount	Gesamtanzahl ungelöschter Datenzeilen.
[out]	unsortedCount	Anzahl unsortiert angefügter Datenzeilen.
[out]	deletedCount	Anzahl als gelöscht markierter Datenzeilen.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableOpen()

DF_API_EXTERN int DF_API_CALL DFCTableOpen	(	int	connectionNumber,
		int	deviceAddress,
		const char *	name,
		int	options,
		int *	tableHandle
	)

Öffnet eine vorhandene Tabelle (Liste) zur Bearbeitung.

Öffnet eine Tabelle und macht diese über einen Handle zugreifbar.

Export

DFComDLL als DFCTableOpen
DFCom_x64 als DFCTableOpen

Zu beachten

Die Bezeichnung Tabelle wurde gewählt, da zukünftig ggf. auch Datensatztabellen über diese Funktionen Bearbeitet werden sollen. Allgemein beziehen sich die Funktionen aktuell jedoch auf Listen.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	name	Tabellenname. Die Tabellen sind in verschiedene Bereiche eingeteilt, welche Sie über einen Namenspräfix ansprechen. Präfix Bedeutung LIST. Listen des Setups. Beispiel: LIST.Personalstamm ACCESS. Listen der Zutrittskontrolle. Beispiel: ACCESS.Reader
[in]	options	Reservierter Parameter. Standardwert 0.
[out]	tableHandle	Variable für den Tabellenhandle. Dieser wird bei den weiteren Funktionsaufrufen zur Bearbeitung als Parameterwert benötigt.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableRemoveFilter()

DF_API_EXTERN int DF_API_CALL DFCTableRemoveFilter	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle
	)

Entfernen eines gesetzten Datenfilters von der Tabelle.

Wurde mit DFCTableSetFilter() ein Filter auf die Tabelle gesetzt, kann dieser durch Aufruf entfernt werden.

Export

DFComDLL als DFCTableRemoveFilter
DFCom_x64 als DFCTableRemoveFilter

Zu beachten

Nach Ausführung dieser Funktion sitzt der Satzzeiger auf der ersten Datenzeile der Tabelle. Mit DFCTableSetCurrentRow() kann der Satzzeiger bewegt werden.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableSetAllRowsToColumnData()

DF_API_EXTERN int DF_API_CALL DFCTableSetAllRowsToColumnData	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags,
		const char *	name,
		const char *	data,
		int	dataSize
	)

Überschreiben einer Spalte der gesamten dem aktuellen Filterkriterium entsprechenden Datenzeilen.

Allen, dem aktuell entpsrechenden Filterkriterium entsprechenden Datenzeilen, wird der angegebene Spaltenwert zugewiesen.

Export

DFComDLL als DFCTableSetAllRowsToColumnData
DFCom_x64 als DFCTableSetAllRowsToColumnData

Zu beachten

Über diese Funktion kann Beispielsweise ein Anwesenheitsstatus aller Mitarbeiter mit einem Aufruf auf einen definierten Zustand eingestellt werden.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung ... Nicht verwendet. Bitte immer 0 übergeben.
[in]	name	Feldname.
[in]	data	Feldwert.
[in]	dataSize	Länge des Feldwertes.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableSetCurrentColumnData()

DF_API_EXTERN int DF_API_CALL DFCTableSetCurrentColumnData	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags,
		const char *	name,
		const char *	data,
		int	dataSize
	)

Überschreiben eines Feldwertes.

Überschreibt in der aktuellen Datenzeile den angegebenen Feldwert.

Export

DFComDLL als DFCTableSetCurrentColumnData
DFCom_x64 als DFCTableSetCurrentColumnData

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung 1 1 Nach der Ausführung wird auf die nächste Datenzeile gewechselt. Dieses erspart ein folgender Aufruf von DFCTableSetCurrentRow(). ... Nicht verwendet. Bitte immer 0 übergeben.
[in]	name	Feldname.
[in]	data	Feldwert.
[in]	dataSize	Länge des Feldwertes.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableSetCurrentRow()

DF_API_EXTERN int DF_API_CALL DFCTableSetCurrentRow	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	offset,
		int	direction
	)

Setzen der aktuellen Zeilennummer.

Setzt den Satzzeiger auf die angegebene Zeilennummer.

Export

DFComDLL als DFCTableSetCurrentRow
DFCom_x64 als DFCTableSetCurrentRow

Zu beachten

Bei einer gefilterten Liste beziehen sich die Angaben auf die dem Filterkriteren entsprechenden Datenzeilen.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	offset	Anzahl zu übergehender Datenzeilen.
[in]	direction	Worauf sich offset beziehen soll. Wert Bedeutung 0 vom Beginn der Tabelle 1 von aktueller Position 2 vom Ende

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableSetCurrentRowData()

DF_API_EXTERN int DF_API_CALL DFCTableSetCurrentRowData	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		int	flags,
		char	separator,
		const char *	data,
		int	dataSize
	)

Überschreibt die aktuelle Datenzeile mit den angegeben Daten.

Die Datenzeile auf welcher der aktuelle Satzzeiger steht wird mit den angegebenen Daten überschrieben.

Export

DFComDLL als DFCTableSetCurrentRowData
DFCom_x64 als DFCTableSetCurrentRowData

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	flags	Gibt zusätzliche Funktionalitäten an. Bitnummer Wert Bedeutung 1 1 Nach der Ausführung wird auf die nächste Datenzeile gewechselt. Dieses erspart ein folgender Aufruf von DFCTableSetCurrentRow(). ... Nicht verwendet. Bitte immer 0 übergeben.
[in]	separator	Angabe der in data enthaltenen Datenfelder. Wert Bedeutung 0 Die Feldwerte sind als Zeichenarray im Binärformat angegeben. 9 Sie sind durch einen Tabulator '\t' voneinander getrennt. 59 Sie sind durch ein Semikolon ';' voneinander getrennt.
[in]	data	Datenarray.
[in]	dataSize	Länge des Datenarrays.

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten

DFCTableSetFilter()

DF_API_EXTERN int DF_API_CALL DFCTableSetFilter	(	int	connectionNumber,
		int	deviceAddress,
		int	tableHandle,
		const char *	value
	)

Setzen eines Datenfilters auf die Tabelle.

Setzt ein Filterkriterium auf Spalten der Tabelle.

Export

DFComDLL als DFCTableSetFilter
DFCom_x64 als DFCTableSetFilter

Warnung

Firmwareversionen kleiner 04.03.08 unterstüzen eine Filterung auf eine Spalte. Sie führen das Setzen von Filterangaben für mehr als eine Spalte fehlerfrei, interpretieren jedoch nur die erste Filterspalte.

Zu beachten

Nach Ausführung dieser Funktion sitzt der Satzzeiger auf der ersten passenden Datenzeile. Mit DFCTableSetCurrentRow() kann der Satzzeiger in den gefilterten Datenzeilen bewegt werden.

Parameter

[in]	connectionNumber	Zu verwendende Verbindungsnummer.
[in]	deviceAddress	Anzusprechende Geräteadresse.
[in]	tableHandle	Tabellenhandle.
[in]	value	Zeichenfolge des Filters. Die Filterangabe wird durch Spaltenname='Spaltenwert' durchgeführt. Ab der Firmwareversion 04.03.08.01 kann zusätzlich eine 2 Spalte angegeben werden: Spaltenname='Spaltenwert';Spaltenname2='Spaltenwert'

Rückgabewerte

0	Fehler bei Ausführung.
1	Ausführung war erfolgreich.

Seit

04.03.08 enthalten