~joel-auterson/ubuntu/maverick/ibus/newmenuname

<link rel="home" href="index.html" title="IBus Reference Manual">

<link rel="up" href="ch04.html" title="Communication and Configuration">

<link rel="chapter" href="ch01.html" title="Overview">

<link rel="chapter" href="ch02.html" title="Panel (User Interfaces)">

<link rel="chapter" href="ch04.html" title="Communication and Configuration">

<link rel="chapter" href="ch05.html" title="Internal">

<td><a accesskey="u" href="ch04.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>

<th width="100%" align="center">IBus Reference Manual</th>

<p>ibuspendingcall — A DBusPendingCall in IBus.</p>

<div class="refsect1" lang="en">

<a name="ibus-ibuspendingcall.stability-level"></a><h2>Stability Level</h2>

Stable, unless otherwise indicated

</div>

An IBusPendingCall is essentially a DBusPendingCall, which representing an expected reply.

A IBusPendingCall can be created when you send a message that should have a reply.

</p>

<p>

Besides DBusPendingCall functions, An IBusPendingCall can be manipulated

with its own specific functions, which are defined in this section.</p>

<p>

An opaque data structure that represents IBusPendingCall.</p>

<p>

Callback prototype of pending call notify function.</p>

<p>

<td> An IBusPendingCall.

<td> User data for the callback function.

Increases the reference count on a pending call.</p>

<p>

<td> An IBusPendingCall.

<td> A reference of IBusPendingCall.

Decreases the reference count on a pending call.</p>

<p>

<td> An IBusPendingCall.

Sets a notification function to be called when the reply is received or the pending call times out.</p>

<p>

<td> An IBusPendingCall.

<td> An pending call notify callback function.

<td> User data for the callback function.

<td> Callback to free the user_data.

<td> TRUE if succeed; FALSE if not enough memory.

Cancels the pending call, such that any reply or error received will just be ignored.

</p>

<p>

Drops the dbus library's internal reference to the DBusPendingCall so will free the call

if nobody else is holding a reference.

But usually application owns a reference from <code class="function">dbus_connection_send_with_reply()</code>.

</p>

<p>

Note that canceling a pending call will not simulate a timed-out call;

if a call times out, then a timeout error reply is received.

If you cancel the call, no reply is received unless the reply was already received before you canceled.</p>

<p>

<td> An IBusPendingCall.

Whether the pending call has received a reply or not.</p>

<p>

<td> An IBusPendingCall.

<td> TRUE if pending call has received a reply; FALSE otherwise.

Gets the reply, or returns NULL if none has been received yet.

</p>

<p>

Ownership of the reply message passes to the caller.

This function can only be called once per pending call,

since the reply message is transferred to the caller.</p>

<p>

<td> An IBusPendingCall.

<td> Replied message; NULL if none has been received yet.

Block until the pending call is completed.

The blocking is as with <a class="link" href="IBusConnection.html#ibus-connection-send-with-reply-and-block" title="ibus_connection_send_with_reply_and_block ()"><code class="function">ibus_connection_send_with_reply_and_block()</code></a>;

it does not enter the main loop or process other messages,

it simply waits for the reply in question.

</p>

<p>

If the pending call is already completed, this function returns immediately.</p>

<p>

<td> An IBusPendingCall.

Wait until the pending call is completed.

</p>

<p>

See also: <a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-get-completed" title="ibus_pending_call_get_completed ()"><code class="function">ibus_pending_call_get_completed()</code></a>.</p>

<p>

<td> An IBusPendingCall.

Allocates an integer ID to be used for storing application-specific data on any IBusPendingCall.

</p>

<p>

The allocated ID may then be used with <a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-set-data" title="ibus_pending_call_set_data ()"><code class="function">ibus_pending_call_set_data()</code></a> and <a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-get-data" title="ibus_pending_call_get_data ()"><code class="function">ibus_pending_call_get_data()</code></a>.

The passed-in slot must be initialized to -1, and is filled in with the slot ID.

If the passed-in slot is not -1, it's assumed to be already allocated, and

its reference count is increased.

</p>

<p>

The allocated slot is global, i.e. all DBusPendingCall objects

will have a slot with the given integer ID reserved.</p>

<p>

<td> Address of a global variable storing the slot.

<td> TRUE if succeed; FALSE if insufficient memory.

Deallocates a global ID for IBusPendingCall data slots.

</p>

<p>

<a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-get-data" title="ibus_pending_call_get_data ()"><code class="function">ibus_pending_call_get_data()</code></a> and <a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-set-data" title="ibus_pending_call_set_data ()"><code class="function">ibus_pending_call_set_data()</code></a> may no longer be used with this slot.

Existing data stored on existing IBusPendingCall objects will be freed when

the IBusPendingCall is finalized, but may not be retrieved

(and may only be replaced if someone else reallocates the slot).

When the reference count on the passed-in slot reaches 0, it is set to -1.</p>

<p>

<td> Address of a global variable storing the slot.

Stores a pointer on a IBusPendingCall, along with an optional function

to be used for freeing the data when the data is set again, or when the pending call is finalized.

</p>

<p>

The slot number must have been allocated with <a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-allocate-data-slot" title="ibus_pending_call_allocate_data_slot ()"><code class="function">ibus_pending_call_allocate_data_slot()</code></a>.</p>

<p>

<td> An IBusPendingCall.

<td> The slot number.

<td> The data to store

<td> Callback to free the data.

<td> TRUE if there was enough memory to store the data; FALSE otherwise.

Retrieves data previously set with <a class="link" href="ibus-ibuspendingcall.html#ibus-pending-call-set-data" title="ibus_pending_call_set_data ()"><code class="function">ibus_pending_call_set_data()</code></a>.

</p>

<p>

The slot must still be allocated (must not have been freed).</p>

<p>

<td> An IBusPendingCall.

<td> The slot number.

<td> The stored data; NULL if no such data.