Functions for Accessing Configuration Information

An introduction to functions used to access configuration information, their purposes, and parameters.

For each RPC plugin, the c8-services.xml file has an entry that contains configuration information about that RPC plugin. These functions access that configuration information.

const C8Char *C8RpcGetServiceName(C8Rpc *rpcctx); – Purpose: Returns the name of the service entry in the c8-services.xml file.
Parameters:
- rpcctx: A pointer to the "context" (data structure) for this particular instance of the plugin.
Returns: A pointer to the service name.
const C8Char *C8RpcGetServiceParameter(C8Rpc *rpcctx, const C8Char *paramName); – Purpose: Returns the value of a given parameter from the services file for this plugin's instance. If the parameter is not found, then NULL is returned.
Parameters:
- rpcctx: A pointer to the "context" (data structure) for this particular instance of the plugin.
- paramName: A string that contains the name of the parameter for which you want the value.
Returns: A string that contains the value of the parameter.
const C8Schema *C8RpcGetInputSchema(C8Rpc *rpcctx); – Purpose: Gets the input messages schema for this instance of the plugin.
Parameters:
- rpcctx: A pointer to the "context" (data structure) for this particular instance of the plugin.
Returns: A pointer to a C8Schema object that describes the schema of the input messages.
const C8Schema* C8RpcGetOutputSchema(C8Rpc *rpcctx); – Purpose: Gets the output messages schema for this plugin's instance.
Parameters:
- rpcctx: A pointer to the "context" (data structure) for this particular instance of the plugin.
Returns: A pointer to a C8Schema object that describes the schema of the output messages.