Name

rd_postimage — Rivendell Post RSS Image C Library Function

Synopsis

#include <rivwebcapi/rd_postimage.h>
int RD_PostImage(hostname[],  
 username[],  
 passwd[],  
 ticket[],  
 img_id,  
 user_agent[]); 
const char hostname[];
const char username[];
const char passwd[];
const char ticket[];
const unsigned img_id;
const char user_agent[];
 

Description

RD_PostImage is the function to use to post an RSS image from the Rivendell database to the remote RSS repository.

Table 1. RD_PostImage function call fields

FIELD NAME FIELD TYPE MEANING REMARKS
hostname Character Array Name Of Rivendell DB Host Mandatory
username Character Array Rivendell User Name Mandatory When NO Ticket Provided
passwd Character Array Rivendell User Password Mandatory When NO Ticket Provided
ticket Character Array Rivendell Authentification Ticket Mandatory When NO User/Password Pair Provided.
img_id unsigned integer Image ID 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 Image ID

403 User Authentification Error.

404 Unauthorized or No Such Image

nnn Unknown Error Occurred.