libshout - function - shout_update_metadata

libshout documentation | libshout version 1.0.4 - 20000824

# 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.

copyright © 2000 icecast team | www.icecast.org team@icecast.org
libshout documentation | libshout version 1.0.4 - 20000824