IP_NserveLookupId

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `IP_NserveLookupId`

`IP_NserveLookupId` -- finds a task by node, process and channel ID.

## Syntax

``int IP_NserveLookupId`(int nid, int pid, int chid, IP_Task* task);`

## Arguments

`nid`

  A node ID.

`pid`

  A process ID.

`chid`

  A channel ID.

`task`

  An empty task structure to hold the result.

## Returns

`0` on success, or `-1` on failure and `errno` is set.

## Description

This function queries nserve for the first task whose `nid`, `pid` and `chid` exactly match the provided values. The task structure is filled in with all information from nserve. Strings are allocated as necessary, and will be deallocated when the task pointer is submitted to `IP_TaskDestroy`.

## See Also

The Cascade NameServer, Cascade NameServer Functions, nserve, `IP_NserveLookup`, `IP_NserveLookupName`

Prev | Home | Next
`IP_NserveLookup` | Up | `IP_NserveLookupName`

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