![]() |
![]() |
![]() |
telepathy-glib API Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Known Implementations | Signals |
Service-side Channel Authentication interfacesService-side Channel Authentication interfaces — GInterfaces to implement authentication channels |
#include <telepathy-glib/telepathy-glib-dbus.h> TpSvcChannelTypeServerAuthentication1; TpSvcChannelTypeServerAuthentication1Class; TpSvcChannelInterfaceSASLAuthentication1; TpSvcChannelInterfaceSASLAuthentication1Class; void (*tp_svc_channel_interface_sasl_authentication1_abort_sasl_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,guint in_Reason
,const gchar *in_Debug_Message
,DBusGMethodInvocation *context
); void (*tp_svc_channel_interface_sasl_authentication1_accept_sasl_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,DBusGMethodInvocation *context
); void tp_svc_channel_interface_sasl_authentication1_emit_new_challenge (gpointer instance
,const GArray *arg_Challenge_Data
); void tp_svc_channel_interface_sasl_authentication1_emit_sasl_status_changed (gpointer instance
,guint arg_Status
,const gchar *arg_Reason
,GHashTable *arg_Details
); void tp_svc_channel_interface_sasl_authentication1_implement_abort_sasl (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_abort_sasl_impl impl
); void tp_svc_channel_interface_sasl_authentication1_implement_accept_sasl (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_accept_sasl_impl impl
); void tp_svc_channel_interface_sasl_authentication1_implement_respond (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_respond_impl impl
); void tp_svc_channel_interface_sasl_authentication1_implement_start_mechanism (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_start_mechanism_impl impl
); void tp_svc_channel_interface_sasl_authentication1_implement_start_mechanism_with_data (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_start_mechanism_with_data_impl impl
); void (*tp_svc_channel_interface_sasl_authentication1_respond_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,const GArray *in_Response_Data
,DBusGMethodInvocation *context
); void tp_svc_channel_interface_sasl_authentication1_return_from_abort_sasl (DBusGMethodInvocation *context
); void tp_svc_channel_interface_sasl_authentication1_return_from_accept_sasl (DBusGMethodInvocation *context
); void tp_svc_channel_interface_sasl_authentication1_return_from_respond (DBusGMethodInvocation *context
); void tp_svc_channel_interface_sasl_authentication1_return_from_start_mechanism (DBusGMethodInvocation *context
); void tp_svc_channel_interface_sasl_authentication1_return_from_start_mechanism_with_data (DBusGMethodInvocation *context
); void (*tp_svc_channel_interface_sasl_authentication1_start_mechanism_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,const gchar *in_Mechanism
,DBusGMethodInvocation *context
); void (*tp_svc_channel_interface_sasl_authentication1_start_mechanism_with_data_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,const gchar *in_Mechanism
,const GArray *in_Initial_Data
,DBusGMethodInvocation *context
); TpSvcChannelInterfaceCaptchaAuthentication1; TpSvcChannelInterfaceCaptchaAuthentication1Class; void (*tp_svc_channel_interface_captcha_authentication1_answer_captchas_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,GHashTable *in_Answers
,DBusGMethodInvocation *context
); void (*tp_svc_channel_interface_captcha_authentication1_cancel_captcha_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,guint in_Reason
,const gchar *in_Debug_Message
,DBusGMethodInvocation *context
); void (*tp_svc_channel_interface_captcha_authentication1_get_captcha_data_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,guint in_ID
,const gchar *in_Mime_Type
,DBusGMethodInvocation *context
); void (*tp_svc_channel_interface_captcha_authentication1_get_captchas_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,DBusGMethodInvocation *context
); void tp_svc_channel_interface_captcha_authentication1_implement_answer_captchas (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_answer_captchas_impl impl
); void tp_svc_channel_interface_captcha_authentication1_implement_cancel_captcha (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_cancel_captcha_impl impl
); void tp_svc_channel_interface_captcha_authentication1_implement_get_captcha_data (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_get_captcha_data_impl impl
); void tp_svc_channel_interface_captcha_authentication1_implement_get_captchas (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_get_captchas_impl impl
); void tp_svc_channel_interface_captcha_authentication1_return_from_answer_captchas (DBusGMethodInvocation *context
); void tp_svc_channel_interface_captcha_authentication1_return_from_cancel_captcha (DBusGMethodInvocation *context
); void tp_svc_channel_interface_captcha_authentication1_return_from_get_captcha_data (DBusGMethodInvocation *context
,const GArray *out_Captcha_Data
); void tp_svc_channel_interface_captcha_authentication1_return_from_get_captchas (DBusGMethodInvocation *context
,const GPtrArray *out_Captcha_Info
,guint out_Number_Required
,const gchar *out_Language
);
GInterface +----TpSvcChannelTypeServerAuthentication1
GInterface +----TpSvcChannelInterfaceSASLAuthentication1
GInterface +----TpSvcChannelInterfaceCaptchaAuthentication1
TpSvcChannelTypeServerAuthentication1 is implemented by TpBasePasswordChannel.
TpSvcChannelInterfaceSASLAuthentication1 is implemented by TpBasePasswordChannel.
The ServerAuthentication channel type represents a request for client/UI processes to carry out authentication with a server.
The SASLAuthentication interface allows authentication via SASL, and also allows providing a simple password to the connection manager for it to use with SASL or non-SASL mechanisms.
The CaptchaAuthentication interface (since 0.17.5) allows interactive captcha-solving so that the user can prove that they are not a bot, on protocols requiring this.
typedef struct _TpSvcChannelTypeServerAuthentication1 TpSvcChannelTypeServerAuthentication1;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelTypeServerAuthentication1Class TpSvcChannelTypeServerAuthentication1Class;
The class of TpSvcChannelTypeServerAuthentication1.
This interface has no D-Bus methods, so an
implementation can typically pass NULL
to
G_IMPLEMENT_INTERFACE()
as the interface
initialization function.
typedef struct _TpSvcChannelInterfaceSASLAuthentication1 TpSvcChannelInterfaceSASLAuthentication1;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelInterfaceSASLAuthentication1Class TpSvcChannelInterfaceSASLAuthentication1Class;
The class of TpSvcChannelInterfaceSASLAuthentication1.
In a full implementation of this interface (i.e. all
methods implemented), the interface initialization
function used in G_IMPLEMENT_INTERFACE()
would
typically look like this:
static void implement_channel_interface_sasl_authentication1 (gpointer klass, gpointer unused G_GNUC_UNUSED) { #define IMPLEMENT(x) tp_svc_channel_interface_sasl_authentication1_implement_##x (\ klass, my_object_##x) IMPLEMENT (start_mechanism); IMPLEMENT (start_mechanism_with_data); IMPLEMENT (respond); IMPLEMENT (accept_sasl); IMPLEMENT (abort_sasl); #undef IMPLEMENT }
void (*tp_svc_channel_interface_sasl_authentication1_abort_sasl_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,guint in_Reason
,const gchar *in_Debug_Message
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method AbortSASL on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
guint (FIXME, generate documentation) |
|
const gchar * (FIXME, generate documentation) |
|
Used to return values or throw an error |
void (*tp_svc_channel_interface_sasl_authentication1_accept_sasl_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method AcceptSASL on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
Used to return values or throw an error |
void tp_svc_channel_interface_sasl_authentication1_emit_new_challenge (gpointer instance
,const GArray *arg_Challenge_Data
);
Type-safe wrapper around g_signal_emit to emit the NewChallenge signal on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
const GArray * (FIXME, generate documentation) |
void tp_svc_channel_interface_sasl_authentication1_emit_sasl_status_changed (gpointer instance
,guint arg_Status
,const gchar *arg_Reason
,GHashTable *arg_Details
);
Type-safe wrapper around g_signal_emit to emit the SASLStatusChanged signal on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
guint (FIXME, generate documentation) |
|
const gchar * (FIXME, generate documentation) |
|
GHashTable * (FIXME, generate documentation) |
void tp_svc_channel_interface_sasl_authentication1_implement_abort_sasl (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_abort_sasl_impl impl
);
Register an implementation for the AbortSASL method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the AbortSASL D-Bus method |
void tp_svc_channel_interface_sasl_authentication1_implement_accept_sasl (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_accept_sasl_impl impl
);
Register an implementation for the AcceptSASL method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the AcceptSASL D-Bus method |
void tp_svc_channel_interface_sasl_authentication1_implement_respond (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_respond_impl impl
);
Register an implementation for the Respond method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the Respond D-Bus method |
void tp_svc_channel_interface_sasl_authentication1_implement_start_mechanism (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_start_mechanism_impl impl
);
Register an implementation for the StartMechanism method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the StartMechanism D-Bus method |
void tp_svc_channel_interface_sasl_authentication1_implement_start_mechanism_with_data (TpSvcChannelInterfaceSASLAuthentication1Class *klass
,tp_svc_channel_interface_sasl_authentication1_start_mechanism_with_data_impl impl
);
Register an implementation for the StartMechanismWithData method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the StartMechanismWithData D-Bus method |
void (*tp_svc_channel_interface_sasl_authentication1_respond_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,const GArray *in_Response_Data
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method Respond on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
const GArray * (FIXME, generate documentation) |
|
Used to return values or throw an error |
void tp_svc_channel_interface_sasl_authentication1_return_from_abort_sasl
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void tp_svc_channel_interface_sasl_authentication1_return_from_accept_sasl
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void tp_svc_channel_interface_sasl_authentication1_return_from_respond
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void tp_svc_channel_interface_sasl_authentication1_return_from_start_mechanism
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void tp_svc_channel_interface_sasl_authentication1_return_from_start_mechanism_with_data
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void (*tp_svc_channel_interface_sasl_authentication1_start_mechanism_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,const gchar *in_Mechanism
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method StartMechanism on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
const gchar * (FIXME, generate documentation) |
|
Used to return values or throw an error |
void (*tp_svc_channel_interface_sasl_authentication1_start_mechanism_with_data_impl) (TpSvcChannelInterfaceSASLAuthentication1 *self
,const gchar *in_Mechanism
,const GArray *in_Initial_Data
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method StartMechanismWithData on interface im.telepathy.v1.Channel.Interface.SASLAuthentication1.
|
The object implementing this interface |
|
const gchar * (FIXME, generate documentation) |
|
const GArray * (FIXME, generate documentation) |
|
Used to return values or throw an error |
typedef struct _TpSvcChannelInterfaceCaptchaAuthentication1 TpSvcChannelInterfaceCaptchaAuthentication1;
Dummy typedef representing any implementation of this interface.
typedef struct _TpSvcChannelInterfaceCaptchaAuthentication1Class TpSvcChannelInterfaceCaptchaAuthentication1Class;
The class of TpSvcChannelInterfaceCaptchaAuthentication1.
In a full implementation of this interface (i.e. all
methods implemented), the interface initialization
function used in G_IMPLEMENT_INTERFACE()
would
typically look like this:
static void implement_channel_interface_captcha_authentication1 (gpointer klass, gpointer unused G_GNUC_UNUSED) { #define IMPLEMENT(x) tp_svc_channel_interface_captcha_authentication1_implement_##x (\ klass, my_object_##x) IMPLEMENT (get_captchas); IMPLEMENT (get_captcha_data); IMPLEMENT (answer_captchas); IMPLEMENT (cancel_captcha); #undef IMPLEMENT }
void (*tp_svc_channel_interface_captcha_authentication1_answer_captchas_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,GHashTable *in_Answers
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method AnswerCaptchas on interface im.telepathy.v1.Channel.Interface.CaptchaAuthentication1.
|
The object implementing this interface |
|
GHashTable * (FIXME, generate documentation) |
|
Used to return values or throw an error |
void (*tp_svc_channel_interface_captcha_authentication1_cancel_captcha_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,guint in_Reason
,const gchar *in_Debug_Message
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method CancelCaptcha on interface im.telepathy.v1.Channel.Interface.CaptchaAuthentication1.
|
The object implementing this interface |
|
guint (FIXME, generate documentation) |
|
const gchar * (FIXME, generate documentation) |
|
Used to return values or throw an error |
void (*tp_svc_channel_interface_captcha_authentication1_get_captcha_data_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,guint in_ID
,const gchar *in_Mime_Type
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method GetCaptchaData on interface im.telepathy.v1.Channel.Interface.CaptchaAuthentication1.
|
The object implementing this interface |
|
guint (FIXME, generate documentation) |
|
const gchar * (FIXME, generate documentation) |
|
Used to return values or throw an error |
void (*tp_svc_channel_interface_captcha_authentication1_get_captchas_impl) (TpSvcChannelInterfaceCaptchaAuthentication1 *self
,DBusGMethodInvocation *context
);
The signature of an implementation of the D-Bus method GetCaptchas on interface im.telepathy.v1.Channel.Interface.CaptchaAuthentication1.
|
The object implementing this interface |
|
Used to return values or throw an error |
void tp_svc_channel_interface_captcha_authentication1_implement_answer_captchas (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_answer_captchas_impl impl
);
Register an implementation for the AnswerCaptchas method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the AnswerCaptchas D-Bus method |
void tp_svc_channel_interface_captcha_authentication1_implement_cancel_captcha (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_cancel_captcha_impl impl
);
Register an implementation for the CancelCaptcha method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the CancelCaptcha D-Bus method |
void tp_svc_channel_interface_captcha_authentication1_implement_get_captcha_data (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_get_captcha_data_impl impl
);
Register an implementation for the GetCaptchaData method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the GetCaptchaData D-Bus method |
void tp_svc_channel_interface_captcha_authentication1_implement_get_captchas (TpSvcChannelInterfaceCaptchaAuthentication1Class *klass
,tp_svc_channel_interface_captcha_authentication1_get_captchas_impl impl
);
Register an implementation for the GetCaptchas method in the vtable of an implementation of this interface. To be called from the interface init function.
|
A class whose instances implement this interface |
|
A callback used to implement the GetCaptchas D-Bus method |
void tp_svc_channel_interface_captcha_authentication1_return_from_answer_captchas
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void tp_svc_channel_interface_captcha_authentication1_return_from_cancel_captcha
(DBusGMethodInvocation *context
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
void tp_svc_channel_interface_captcha_authentication1_return_from_get_captcha_data (DBusGMethodInvocation *context
,const GArray *out_Captcha_Data
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
|
const GArray * (FIXME, generate documentation) |
void tp_svc_channel_interface_captcha_authentication1_return_from_get_captchas (DBusGMethodInvocation *context
,const GPtrArray *out_Captcha_Info
,guint out_Number_Required
,const gchar *out_Language
);
Return successfully by calling dbus_g_method_return()
.
This inline function exists only to provide type-safety.
|
The D-Bus method invocation context |
|
const GPtrArray * (FIXME, generate documentation) |
|
guint (FIXME, generate documentation) |
|
const gchar * (FIXME, generate documentation) |
"new-challenge"
signalvoid user_function (TpSvcChannelInterfaceSASLAuthentication1 *self,
GArray_guchar_ *arg_Challenge_Data,
gpointer user_data) : Has Details
The NewChallenge D-Bus signal is emitted whenever this GObject signal is.
|
an object |
|
const GArray * (FIXME, generate documentation) |
|
user data set when the signal handler was connected. |
"s-as-lstatus-changed"
signalvoid user_function (TpSvcChannelInterfaceSASLAuthentication1 *self,
guint arg_Status,
gchar *arg_Reason,
gpointer user_data) : Has Details
The SASLStatusChanged D-Bus signal is emitted whenever this GObject signal is.
|
an object |
|
guint (FIXME, generate documentation) |
|
const gchar * (FIXME, generate documentation) |
|
GHashTable * (FIXME, generate documentation) |
|
user data set when the signal handler was connected. |