send_message


Description:

public bool send_message (DBusMessage message, DBusSendMessageFlags flags, out uint32 out_serial) throws Error

Asynchronously sends message to the peer represented by this.

Unless flags contain the g_dbus_send_message_flags_preserve_serial flag, the serial number will be assigned by this and set on message via set_serial. If out_serial is not null, then the serial number used will be written to this location prior to submitting the message to the underlying transport. While it has a `volatile` qualifier, this is a historical artifact and the argument passed to it should not be `volatile`.

If this is closed then the operation will fail with g_io_error_closed. If message is not well-formed, the operation fails with g_io_error_invalid_argument.

See this server and client for an example of how to use this low-level API to send and receive UNIX file descriptors.

Note that message must be unlocked, unless flags contain the g_dbus_send_message_flags_preserve_serial flag.

Parameters:

this

a DBusConnection

message

a DBusMessage

flags

flags affecting how the message is sent

out_serial

return location for serial number assigned to message when sending it or null

Returns:

true if the message was well-formed and queued for transmission, false if throws is set