set_source_tag
Description:
[ Version ( since = "2.36" ) ]
public void set_source_tag (void* source_tag)
public void set_source_tag (void* source_tag)
Sets this's source tag.
You can use this to tag a task return value with a particular pointer (usually a pointer to the function doing the tagging) and then later check it using get_source_tag (or is_tagged) in the task's "finish" function, to figure out if the response came from a particular place.
A macro wrapper around this function will automatically set the task’s name to the string form of source_tag
if it’s not
already set, for convenience.
Parameters:
this |
the Task |
source_tag |
an opaque pointer indicating the source of this task |