summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonny Lamb <jonny.lamb@collabora.co.uk>2011-01-05 16:18:07 +0000
committerJonny Lamb <jonny.lamb@collabora.co.uk>2011-01-05 16:18:07 +0000
commit3638d790f61b5ca5d59171cd3f296e66e10127e3 (patch)
tree006178e1cb4a137bd0ad5dd3fda9715685f64f06
parent82c7eef57a72a2bc5f620827cc95f7a67eca2042 (diff)
handle: add a TP_HANDLE_NONEnone-handle
Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
-rw-r--r--docs/reference/telepathy-glib-sections.txt1
-rw-r--r--telepathy-glib/handle.h10
2 files changed, 11 insertions, 0 deletions
diff --git a/docs/reference/telepathy-glib-sections.txt b/docs/reference/telepathy-glib-sections.txt
index aa83aebd8..e6b2e19d3 100644
--- a/docs/reference/telepathy-glib-sections.txt
+++ b/docs/reference/telepathy-glib-sections.txt
@@ -1847,6 +1847,7 @@ tp_debug_set_all_flags
TpHandle
TP_TYPE_HANDLE
TP_UNKNOWN_HANDLE_TYPE
+TP_HANDLE_NONE
tp_handle_type_is_valid
tp_handle_type_to_string
</SECTION>
diff --git a/telepathy-glib/handle.h b/telepathy-glib/handle.h
index 79ad09737..036ff35e7 100644
--- a/telepathy-glib/handle.h
+++ b/telepathy-glib/handle.h
@@ -59,6 +59,16 @@ typedef guint TpHandle;
#define TP_UNKNOWN_HANDLE_TYPE ((TpHandleType) -1)
/**
+ * TP_HANDLE_NONE:
+ *
+ * A handle that can be used as a "null" value to mean the absence of
+ * a contact, room, etc.
+ *
+ * Since: 0.13.UNRELEASED
+ */
+#define TP_HANDLE_NONE ((TpHandle) 0)
+
+/**
* tp_handle_type_is_valid:
* @type: A handle type, valid or not, to be checked
* @error: Set if the handle type is invalid