IP_TaskCreateMe

IP_TaskCreateMe — creates a task structure for the current process.

Syntax

#include <cogent.h>
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