CA_Set_CA_Version()

Purpose

Declare the version level of the custom server library that the application uses.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
int CA_Set_CA_Version (
CA_VERSION_ENUM version
);

Description

Use this subroutine to specify the level of the custom server library against which the custom server program was compiled. Call this subroutine before calling the CA_Init() subroutine.

A call to this subroutine is generated automatically in a system-generated main() function.

Parameters

version
Specifies the version of the custom server library. Use the value CA_VERSION_ID to specify the most recent version.

Return codes

0
Successful
-1
Unsuccessful (global error number CA_errno is set to indicate the error)

Error names

CA_ALREADY_STARTED
CA_Set_CA_Version() must be called before CA_Init().
CA_INV_VERSION
Invalid version. This value is returned when the version parameter is outside the range of valid versions. This may indicate that you are trying to use a custom server that was compiled with a later version of the custom server library, or that there is a programming error in the custom server program.
Note: This error is not returned if the custom server was compiled with an earlier version of the custom server library. In that case the return code is 0.

Related information

CA_Init(), CA_Set_Options().