IP_TaskFindName

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `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`

Prev | Home | Next
`IP_TaskFindID` | Up | `IP_TaskInitAsync`

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