#include <gre/gre.h>
int gr_context_get_group(
gr_action_context_t *action_context,
char *buffer,
int buffer_len
);
The gr_context_get_group function stores the fully qualified name of the group 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 groups fully qualifed name in, the first character may be
set to null, if there is no group 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 group name if there is a group in the context, -1 otherwise
The gr_context_get_group function will build the fully qulified name for the group 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 group context in the
action context, the function will return -1 and set the first character in buffer to NULL.