int libcox_init(libcox **ppHandle);
Obtaining a new libcox handle.
This routine allocate and initialize a new libcox handle. The handle is usually returned in *ppHandle but, if the engine is unable to allocate memory to hold the libcox object, a NULL will be written into *ppHandle instead of a pointer to the libcox object. This routine is often the first API call that an application makes and is a prerequisite in order to play with the library.
After the freshly created handle is ready to execute on more commands via libcox_exec() or libcox_exec_fmt().
OUT: A fresh libcox handle is written into this pointer.
LIBCOX_OK is returned on success. Any other return value indicates failure.