IP_TaskFindName

IP_TaskFindName -- finds a task by its name.

Syntax

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

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.