Error Protocols

The load() method can take a loadhint with multiple bits set. The following error protocols are used:

• If the only error the derivative receives during load is KCS_PFMT_NO_DATA_SUPPORT_4_REQUEST and everything loads successfully, return KCS_SUCCESS.

  Say, for example, you ask for a forward complete and the derivative also tries to load the reverse complete (for optimization). If the reverse receives an error but forward succeeds, KCS_SUCCESS is returned.

• If nothing requested is available, return KCS_PFMT_NO_DATA_SUPPORT_4_REQUEST.

• Any other errors that occur should be returned, and the object should unload itself before exiting. A failure during load() (other than KCS_PFMT_NO_DATA_SUPPORT_4_REQUEST) results in an object for which the loadhints requested are unloaded.