CS_NOAPI_CHK determines whether Client-Library performs argument and state checking when the application calls a Client-Library routine.
When CS_NOAPI_CHK is CS_FALSE (the default value), Client-Library performs checking. With this setting, Client-Library performs the following error checking each time you call a Client-Library routine:
Validates parameter values
Checks field values in visible structures for illegal combinations
Verifies that the application is in a correct state for execution of that function
If a problem is discovered, the routine fails and an error message is generated.
When CS_NOAPI_CHK is CS_TRUE, Client-Library’s usual checking is disabled. The effect of this is as follows:
If the application passes an invalid argument or calls a routine at the wrong time, the application experiences memory corruption, memory access violations, or incorrect results.
With API checking disabled, Client-Library does not check for usage errors. Some usage errors are not trapped with API checking disabled. With API checking enabled, these errors generate error messages; with API checking disabled, they cause incorrect application behavior.
WARNING! Do not disable API checking until after you have completely debugged the application.