IP_TaskCreateMe

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `IP_TaskCreateMe`

`IP_TaskCreateMe` -- creates a task structure for the current process.

## Syntax

``IP_Task* IP_TaskCreateMe`(int chid, char* name, char* domain, char* qname, int qsize);`

## Arguments

`chid`

  A channel ID, or `0`.

`name`

  A name for this task.

`domain`

  A Cascade DataHub domain name.

`qname`

  A queue name, or `NULL`.

`qsize`

  The maximum number of messages in the queue, or `0`.

## Returns

A pointer to a new task structure or `NULL` on failure. This function might fail if a `qname` is specified but the queue name either already exists, or could not be created.

## Description

This function creates a task structure referring to the current process. If `domain` is `NULL`, then the default domain is used. If `qname` is non-`NULL`, then the queue is created and opened as read-only. If `qsize` is `0`, then the default of `100` is used.

## See Also

Task Structures, `IP_TaskSetInfo`, `IP_TaskCreateMe`, `IP_TaskDefaultDomain`, `IP_TaskDestroy`

Prev | Home | Next
`IP_TaskCreate` | Up | `IP_TaskDefaultDomain`

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