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.
