#include <cat/cat.h>
int catinfo_get(cat_session *sess, const char *name, char **result);
The data is read, on demand, from permanent storage. This means that if an entry for the service ``oracle-1'' is not present in the tree, but there is a configuration file or registry key, data can be read in from permanent storage, but only the data for this specific service. Calls to catinfo_loadfrom() must have been made to enable the loading of data from files or the registry.
Memory is allocated for the result. If no value is found, the result is set
to NULL
. Allocated memory must be freed by the caller.
A successful call to catinfo_init() must have been made prior to any call to this function.
catinfo_get() returns 0 if successful or a negative code on error. Specifically, the function returns CAT_ENODE if name refers to a node, or CAT_ENOTFOUND if name does not exist in the tree.