CA_Open_CHP_Link()

Purpose

Establishes a binding between a custom server and a channel process.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
short CA_Open_CHP_Link (
 unsigned short  reserved
);

Description

This subroutine attempts to allocate a free channel process to a custom server. With a channel process link, a custom server can request that a state table be executed.

Parameters

reserved

This parameter is reserved, and will always be set to zero internally.

Return codes

0

Successful; the link_id of the assigned channel process

-1

Unsuccessful (global error number CA_errno is set to indicate the error)

Error names

CA_ACCESS_NOBUFS
CA_INV_LINK_ID
CA_NO_LINK_AVAIL
CA_NO_MSG_RECV
CA_NOT_INIT
CA_REQ_FAILED
CA_TERMINATING

Related information

CA_Close_CHP_Link(), CA_Ping_CHP_Link(), CA_Execute_State_Table().