shout_update_metadata

declared in <shout/shout.h>

The shout_update_metadata function opens a connection to an icecast server. It also logs into the server with the password set for the connection using either the icy or x-audiocast protocols.

int shout_update_metadata( shout_conn_t *self, /* pointer to the connection structure */ char *metadata /* string with the metadata information */ );

Parameters

self

pointer to the connection structure

metadata

string containing the metadata information

Return Values

Returns true (1) on success or false (0) on failure. If the function fails, self->error will contain the error code.

error code	reason
SHOUTERR_INSANE	Function failed the sanity check. The ip, password, or port was invalid, or there is not an established connection.
SHOUTERR_NOCONNECT	A connection to the server could not be established.
SHOUTERR_MALLOC	There wasn't enough free memory for malloc().
SHOUTERR_METADATA	An error occured sending the metadata information.