Name

rd_copyaudio — Rivendell Audio Store C Library Function

Synopsis

#include <rivwebcapi/rd_copyaudio.h>
int RD_CopyAudio(hostname[],  
 username[],  
 passwd[],  
 ticket[],  
 src_cartnumber,  
 src_cutnumber,  
 dest_cartnumber,  
 dest_cutnumber,  
 user_agent[]); 
const char hostname[];
const char username[];
const char passwd[];
const char ticket[];
const unsigned src_cartnumber;
const unsigned src_cutnumber;
const unsigned dest_cartnumber;
const unsigned dest_cutnumber;
const char user_agent[];
 

Description

RD_CopyAudio is the function to use to copy PCM/MPEG data from one Source Cart/Cut to a Destination Cart/Cut.

Table 1. RD_CopyAudio function call fields

FIELD NAME FIELD TYPE MEANING REMARKS
hostname Character Array Name Of Rivendell DB Host Mandatory When NO Ticket Provided
username Character Array Rivendell User Name Mandatory
passwd Character Array Rivendell User Password Mandatory When NO Ticket Provided
ticket Character Array Rivendell Authentification Ticket Mandatory When NO User/Password Pair Provided.
src_cartnumber unsigned integer Source Cart Number Mandatory
src_cutnumber unsigned integer Source Cut Number Mandatory
dest_cartnumber unsigned integer Destination Cart Number Mandatory
dest_cutnumber unsigned integer Destination Cut Number Mandatory
user_agent Character Array User Agent Value put into HTTP request Optional (default is Rivendell-C-API/x.x.x)

RETURN VALUE

On success, zero is returned.

If a server error occurs a -1 is returned. If a client error occurs a specific error number is returned.

ERRORS

400 Missing Cart Number / Cut Number Error.

400 Could Not Link Cart/Cut Number Error.

403 User Authentification Error.

404 No Such Cart.

nnn Unknown Error Occurred.