CA_Get_Profile_Count()

Purpose

Retrieves the application profile count that meets the input criteria.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
#include "CA_access_db.h"
int CA_Get_Profile_Count (
 PROFILE_LIST_PARM_ST  *profile_list_parm_sp
);

Description

This subroutine returns the number of application profiles that meet with the input criteria. The criteria can be start profile ID, end profile ID and the state table name. If there are no criteria specified, then the total count of all existing application profiles is returned.

Parameters

profile_list_parm_sp
A pointer to a PROFILE_LIST_PARM_ST input structure that is filled in as described in PROFILE_LIST_PARM_ST.

Return codes

0
Successful; number of application profiles that match the specified criteria
-1
Unsuccessful (global error number CA_errno is set to indicate the error)

Error names

CA_ACCESS_NOBUFS
CA_INV_ADDR
CA_INV_PROFILE_ID
CA_INV_PROFILE_NAME
CA_INV_REQUEST
CA_INV_STATE_TABLE_NAME
CA_NO_MSG_RECV
CA_NOT_INIT
CA_REQ_FAILED
CA_TERMINATING

Related information

CA_Create_Profile(), CA_Delete_Profile(), CA_Get_Profile(), CA_Get_Profile_List(), CA_Set_Profile_Defaults(), CA_Update_Profile(), the Blueworx Voice Response for AIX: Designing and Managing State Table Applications information.