Method

PurpleProtocolMediainitiate_session

since: 3.0.0

Declaration [src]

gboolean
purple_protocol_media_initiate_session (
  PurpleProtocolMedia* media,
  PurpleAccount* account,
  const gchar* who,
  PurpleMediaSessionType type
)

Description [src]

Initiates a media connection of type to who.

Available since: 3.0.0

Parameters

account

Type: PurpleAccount

The PurpleAccount instance.

The data is owned by the caller of the function.

who

Type: const gchar*

The user to initiate a media session with.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

type

Type: PurpleMediaSessionType

The type of media session to create.

Return value

Type: gboolean

TRUE if successful, FALSE otherwise.