| Input Parameters | Significance |
| DtvLong idf | field Id |
| char *str | search string |
| Output Parameters | Significance |
| no | - |
| Return Code | Significance |
| 0 | no error |
| -1 | field Id is NULL |
If you pass a zero pointer as search string, the function deletes the old contents of the query buffer.