Previous Topic

Next Topic

Filter Callback Errors

The following errors can occur when attempting to load a filter callback library:

  • CBKD_ERR (867, Failed to load the filter callback library. See CTSTATUS.FCS for details.)
  • CBKF_ERR (868, Failed to resolve the filter callback function in the filter callback DLL. See CTSTATUS.FCS for details.)

Errors logged to CTSTATUS.FCS when failing to load a filter callback DLL begin with the text:

FILTER_CALLBACK_LOAD:

A callback DLL that is loaded by a call to SETFLTR() is unloaded when the filter is disabled, which is done either by a call to SETFLTR() to establish a different filter (or with an empty string to disable the filter), or when the file it closed.

A callback DLL can also be specified in an expression that is passed to UPDCIDX(). In that case, the DLL is loaded when the file is physically opened, and the DLL remains loaded until the file is physically closed. Note that if the expression passed to UPDCIDX() specifies the name of a filter callback DLL, then every time the data file is opened the DLL must be able to be loaded and the callback function must exist in the DLL. Otherwise the attempt to open the data file will fail with error 867 or 868.