Function
GioDBusConnectionnew
since: 2.26
Declaration [src]
void
g_dbus_connection_new (
GIOStream* stream,
const gchar* guid,
GDBusConnectionFlags flags,
GDBusAuthObserver* observer,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description [src]
Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
with the end represented by stream.
If stream is a GSocketConnection, then the corresponding GSocket
will be put into non-blocking mode.
The D-Bus connection will interact with stream from a worker thread.
As a result, the caller should not interact with stream after this
method has been called, except by calling g_object_unref() on it.
If observer is not NULL it may be used to control the
authentication process.
When the operation is finished, callback will be invoked. You can
then call g_dbus_connection_new_finish() to get the result of the operation.
This is an asynchronous failable constructor. See
g_dbus_connection_new_sync() for the synchronous version.
Available since: 2.26
This function completes asynchronously. Use g_dbus_connection_new_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
stream-
Type:
GIOStreamA
GIOStream.The data is owned by the caller of the function. guid-
Type:
const gchar*The GUID to use if authenticating as a server or
NULL.The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. flags-
Type:
GDBusConnectionFlagsFlags describing how to make the connection.
observer-
Type:
GDBusAuthObserverA
GDBusAuthObserverorNULL.The argument can be NULL.The data is owned by the caller of the function. cancellable-
Type:
GCancellableA
GCancellableorNULL.The argument can be NULL.The data is owned by the caller of the function. callback-
Type:
GAsyncReadyCallbackA
GAsyncReadyCallbackto call when the request is satisfied. user_data-
Type:
gpointerThe data to pass to
callback.The argument can be NULL.The data is owned by the caller of the function.