TpHandle
TpHandle — type representing handles
|
|
Includes
#include <telepathy-glib/telepathy-glib.h>
Description
The TpHandle type represents a Telepathy handle.
Functions
tp_handle_type_is_valid ()
gboolean
tp_handle_type_is_valid (TpHandleType type,
GError **error);
If the given handle type is valid, return TRUE. If not, set error
and return FALSE.
Returns
TRUE if the handle type is valid.
tp_handle_type_to_string ()
const gchar *
tp_handle_type_to_string (TpHandleType type);
Returns
a human-readable string describing the handle type, e.g. "contact".
For invalid handle types, returns "(no handle)" for 0 or
"(invalid handle type)" for others.
Types and Values
TpHandle
typedef guint TpHandle;
Type representing Telepathy handles within telepathy-glib.
This is guint despite the wire protocol having 32-bit integers, because
dbus-glib expects GArrays of guint and so on. If the dbus-glib ABI changes
in future, telepathy-glib is likely to have a matching ABI change.
TP_TYPE_HANDLE
#define TP_TYPE_HANDLE G_TYPE_UINT
The GType of a TpHandle, currently G_TYPE_UINT.
This won't change unless in an ABI-incompatible version of telepathy-glib.
TP_UNKNOWN_HANDLE_TYPE
#define TP_UNKNOWN_HANDLE_TYPE ((TpHandleType) -1)
An invalid handle type (-1 cast to TpHandleType) used to represent an
unknown handle type.
Since: 0.7.0
See Also
TpHandleRepoIface
