Cogent API and Utilities: Version 4.1
PrevNext

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

PrevHomeNext
IP_TaskCreateUpIP_TaskDefaultDomain

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