CA_Save_Voice_Msg()

Purpose

Changes message status from new to saved.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
#include "CA_access_db.h"
int CA_Save_Voice_Msg (
 SAVE_VOICE_MSG_PARM_ST  *save_voice_msg_parm_sp
);

Description

This subroutine changes the message status from New, Checked, Listened, or Undeliverable to Saved.

Calling this subroutine for a voice message that is already in Saved state will not result in an error.

Parameters

save_voice_msg_parm_sp

A pointer to a SAVE_VOICE_MSG_PARM_ST input structure that is filled in as described in SAVE_VOICE_MSG_PARM_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_MAILBOX_ID
CA_INV_PROFILE_ID
CA_INV_REQUEST
CA_NO_MSG_RECV
CA_NOT_INIT
CA_REQ_FAILED
CA_TERMINATING
CA_VOICE_MSG_NOT_FOUND

Related information

CA_Create_Voice_Msg(), CA_Create_Voice_Msg_Id(), CA_Delete_Voice_Msg(), CA_Get_Voice_Msg(), CA_Get_Voice_Msg_Info(), CA_Send_Voice_Msg(), CA_Set_Send_Voice_Msg_Defaults().