c8client.h

The c8client.h library contains the following functions:

• C8Status C8ClientSDKInitialize(const C8Char * i_progname, const C8Char * i_pref_file); – Purpose: This function initializes the SDK. This function must be called before calling any of the functions in the out-of-process adapter API or the control API. Call the function C8ClientSDKShutdown() when the SDK is no longer needed.

  Parameters:

  • i_progname: Program name used for logging.

  • i_pref_file: Path to preferences file to use. Pass NULL to specify no preferences file and to use defaults.

  Returns: C8_OK if successful, C8_FAIL otherwise.

  Warning!  

  If you are writing an out-of-process adapter that uses SSL, you must create a subdirectory named secure in the directory containing your executable. To store your security certificate information, copy the secure directory into the same directory as your executable from the top-level directory of either the Sybase CEP Server or Sybase CEP Studio installation. If the Sybase CEP application running when you attempt this step, you will see an error similar to the following:

  CRITICAL ERROR: Error: Error while generating certificate (Reason='Error: failed to initialize internal key slot')

• C8Status C8ClientSDKShutdown(); – Purpose: This function cleans up after using the out-of-process adapter SDK or the server control SDK. No SDK functions may be called after the call to C8ClientSDKShutdown().

  Parameters: None.

  Returns: C8_OK on success, C8_FAIL otherwise.