IP_TaskFindName

IP_TaskFindName — finds a task by its name.

Syntax

#include <cogent.h>

IP_Task* IP_TaskFindName(char* name);

Arguments

name

The task name to be found.

Returns

A pointer to a cached IP_Task structure if the name matches, or NULL.

Description

This function searches the current process's task cache for the specified name. It will return the first exact match that it encounters. Names should be unique throughout the system, though it is possible that more than one task could register a name under certain network conditions, and therefore more than one task could be cached with the same name.

See Also

Task Structure Caching, IP_TaskFindID