CA_Get_Profile()

Purpose

Retrieves an application profile.

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 (
 char             *profile_id,
 PROFILE_INFO_ST  *profile_info_sp
);

Description

This subroutine retrieves the information about a particular profile. The application profile name, mailbox information, state table name, state table entry point, and the language code are returned in the PROFILE_INFO_ST output structure.

Parameters

profile_id

Application profile ID.

profile_info_sp

A pointer to the PROFILE_INFO_ST output structure that will be filled in as described in PROFILE_INFO_ST.

Return codes

0

Successful

-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_REQUEST
CA_NO_MSG_RECV
CA_NOT_INIT
CA_PROFILE_NOT_FOUND
CA_REQ_FAILED
CA_TERMINATING

Related information

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