#include <gre/gre.h> int gr_context_get_layer( gr_action_context_t *action_context, char *buffer, int buffer_len );
gr_context_get_layer function stores the fully qualified name of the layer in the buffer provided up to buffer_len characters.
Parameters: action_context The action context to get the fully qualified name from buffer The character buffer to store the layers fully qualifed name in, the first character may be set to null, if there is no layer in the action context buffer_len The storage space that the buffer has to store the name, see function gr_context_max_fqn Returns: The length of the layer name if there is a layer in the context, -1 otherwise
gr_context_get_layer function will build the fully qulified name for the layer context based on the action context and store it in the buffer that is provided, up to buffer_len bytes. It will return the length of the fully qualified name. If there is no layer context in the action context, the function will return -1 and set the first character in buffer to NULL.