| Wocky Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
#include <wocky/wocky-pep-service.h>
WockyPepService;
WockyPepServiceClass;
WockyPepServicePrivate;
WockyPepService * wocky_pep_service_new (const gchar *node,
gboolean subscribe);
void wocky_pep_service_start (WockyPepService *self,
WockySession *session);
void wocky_pep_service_get_async (WockyPepService *self,
WockyBareContact *contact,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
WockyStanza * wocky_pep_service_get_finish (WockyPepService *self,
GAsyncResult *result,
GError **error);
WockyStanza * wocky_pep_service_make_publish_stanza
(WockyPepService *self,
WockyNode **item);
"node" gchar* : Read / Write / Construct Only "subscribe" gboolean : Read / Write / Construct Only
typedef struct _WockyPepService WockyPepService;
Object to aid with looking up PEP nodes and listening for changes.
WockyPepService * wocky_pep_service_new (const gchar *node,gboolean subscribe);
A convenience function to create a new WockyPepService object.
|
the namespace of the PEP node |
|
TRUE if Wocky is to subscribe to the notifications of
the node, otherwise FALSE
|
Returns : |
a new WockyPepService |
void wocky_pep_service_start (WockyPepService *self,WockySession *session);
Start listening to the PEP node node and signal changes by using
"changed".
|
a WockyPepService object |
|
a WockySession object |
void wocky_pep_service_get_async (WockyPepService *self,WockyBareContact *contact,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Starts an asynchronous operation to get the PEP node, "node".
When the operation is complete, callback will be called and the
function should call wocky_pep_service_get_finish().
|
a WockyPepService object |
|
a WockyBareContact object |
|
an optional GCancellable object, or NULL
|
|
a function to call when the node is retrieved |
|
user data for callback
|
WockyStanza * wocky_pep_service_get_finish (WockyPepService *self,GAsyncResult *result,GError **error);
Finishes an asynchronous operation to get the PEP node,
"node". For more details, see
wocky_pep_service_get_async().
|
a WockyPepService object |
|
a GAsyncResult |
|
a location to store a GError if an error occurs |
Returns : |
the WockyStanza retrieved from getting the PEP node. |
WockyStanza * wocky_pep_service_make_publish_stanza (WockyPepService *self,WockyNode **item);
Generates a new IQ type='set' PEP publish stanza.
|
a WockyPepService |
|
a location to store the item WockyNode, or NULL
|
Returns : |
a new WockyStanza PEP publish stanza; free with g_object_unref()
|
"node" property"node" gchar* : Read / Write / Construct Only
Namespace of the PEP node.
Default value: NULL
"changed" signalvoid user_function (WockyPepService *self, WockyBareContact *contact, WockyStanza *stanza, gpointer user_data) : Run Last / Has Details
Emitted when the node value changes.
|
a WockyPepService object |
|
the WockyBareContact who changed the node |
|
the WockyStanza |
|
user data set when the signal handler was connected. |