~ubuntu-branches/ubuntu/utopic/telepathy-glib/utopic : revision 67

30

33

<h2><a name="telepathy-glib-channel-auth.top_of_page"></a>Channel Authentication interfaces</h2>

31

34

Channel Authentication interfaces — client-side wrappers for authentication channels

32

35

</td>

33

36

34

37

</tr></table></div>

35

36

<a name="telepathy-glib-channel-auth.functions"></a><h2>Functions</h2>

37

38

39

40

41

</colgroup>

42

<tbody>

43

<tr>

44

45

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

46

</td>

47

48

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_call_abort_sasl ()">tp_cli_channel_interface_sasl_authentication_call_abort_sasl</a> ()

49

</td>

50

</tr>

51

<tr>

52

53

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

54

</td>

55

56

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_call_accept_sasl ()">tp_cli_channel_interface_sasl_authentication_call_accept_sasl</a> ()

57

</td>

58

</tr>

59

<tr>

60

61

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

62

</td>

63

64

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-respond" title="tp_cli_channel_interface_sasl_authentication_call_respond ()">tp_cli_channel_interface_sasl_authentication_call_respond</a> ()

65

</td>

66

</tr>

67

<tr>

68

69

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

70

</td>

71

72

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_call_start_mechanism ()">tp_cli_channel_interface_sasl_authentication_call_start_mechanism</a> ()

73

</td>

74

</tr>

75

<tr>

76

77

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

78

</td>

79

80

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data ()">tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data</a> ()

81

</td>

82

</tr>

83

<tr>

84

85

void

86

</td>

87

88

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()">*tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl</a>) ()

89

</td>

90

</tr>

91

<tr>

92

93

void

94

</td>

95

96

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()">*tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl</a>) ()

97

</td>

98

</tr>

99

<tr>

100

101

void

102

</td>

103

104

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-respond" title="tp_cli_channel_interface_sasl_authentication_callback_for_respond ()">*tp_cli_channel_interface_sasl_authentication_callback_for_respond</a>) ()

105

</td>

106

</tr>

107

<tr>

108

109

void

110

</td>

111

112

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()">*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism</a>) ()

113

</td>

114

</tr>

115

<tr>

116

117

void

118

</td>

119

120

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()">*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data</a>) ()

121

</td>

122

</tr>

123

<tr>

124

125

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> *

126

</td>

127

128

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-connect-to-new-challenge" title="tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge ()">tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge</a> ()

129

</td>

130

</tr>

131

<tr>

132

133

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> *

134

</td>

135

136

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-connect-to-sasl-status-changed" title="tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed ()">tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed</a> ()

137

</td>

138

</tr>

139

<tr>

140

141

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

142

</td>

143

144

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_call_answer_captchas ()">tp_cli_channel_interface_captcha_authentication_call_answer_captchas</a> ()

145

</td>

146

</tr>

147

<tr>

148

149

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

150

</td>

151

152

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_call_cancel_captcha ()">tp_cli_channel_interface_captcha_authentication_call_cancel_captcha</a> ()

153

</td>

154

</tr>

155

<tr>

156

157

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

158

</td>

159

160

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_call_get_captcha_data ()">tp_cli_channel_interface_captcha_authentication_call_get_captcha_data</a> ()

161

</td>

162

</tr>

163

<tr>

164

165

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

166

</td>

167

168

<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-get-captchas" title="tp_cli_channel_interface_captcha_authentication_call_get_captchas ()">tp_cli_channel_interface_captcha_authentication_call_get_captchas</a> ()

169

</td>

170

</tr>

171

<tr>

172

173

void

174

</td>

175

176

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()">*tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas</a>) ()

177

</td>

178

</tr>

179

<tr>

180

181

void

182

</td>

183

184

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()">*tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha</a>) ()

185

</td>

186

</tr>

187

<tr>

188

189

void

190

</td>

191

192

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()">*tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data</a>) ()

193

</td>

194

</tr>

195

<tr>

196

197

void

198

</td>

199

200

(<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()">*tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas</a>) ()

201

</td>

202

</tr>

203

</tbody>

204

</table></div>

205

</div>

206

207

<a name="telepathy-glib-channel-auth.object-hierarchy"></a><h2>Object Hierarchy</h2>

208

209

</pre>

210

</div>

211

212

<a name="telepathy-glib-channel-auth.includes"></a><h2>Includes</h2>

213

<pre class="synopsis">#include <telepathy-glib/telepathy-glib-dbus.h>

38

39

<a name="telepathy-glib-channel-auth.synopsis"></a><h2>Synopsis</h2>

40

41

#include <telepathy-glib/telepathy-glib-dbus.h>

42

43

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_call_abort_sasl ()">tp_cli_channel_interface_sasl_authentication_call_abort_sasl</a>

44

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

45

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

46

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_Reason</code>,

47

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Debug_Message</code>,

48

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()">tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl</a> callback</code>,

49

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

50

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

51

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

52

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_call_accept_sasl ()">tp_cli_channel_interface_sasl_authentication_call_accept_sasl</a>

53

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

54

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

55

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()">tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl</a> callback</code>,

56

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

57

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

58

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

59

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-respond" title="tp_cli_channel_interface_sasl_authentication_call_respond ()">tp_cli_channel_interface_sasl_authentication_call_respond</a>

60

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

61

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

62

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Response_Data</code>,

63

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-respond" title="tp_cli_channel_interface_sasl_authentication_callback_for_respond ()">tp_cli_channel_interface_sasl_authentication_callback_for_respond</a> callback</code>,

64

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

65

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

66

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

67

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_call_start_mechanism ()">tp_cli_channel_interface_sasl_authentication_call_start_mechanism</a>

68

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

69

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

70

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mechanism</code>,

71

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism</a> callback</code>,

72

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

73

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

74

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

75

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-call-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data ()">tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data</a>

76

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

77

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

78

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mechanism</code>,

79

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Initial_Data</code>,

80

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data</a> callback</code>,

81

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

82

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

83

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

84

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()">*tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl</a>)

85

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

86

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

87

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

88

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

89

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()">*tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl</a>)

90

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

91

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

92

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

93

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

94

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-respond" title="tp_cli_channel_interface_sasl_authentication_callback_for_respond ()">*tp_cli_channel_interface_sasl_authentication_callback_for_respond</a>)

95

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

96

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

97

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

98

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

99

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()">*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism</a>)

100

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

101

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

102

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

103

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

104

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()">*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data</a>)

105

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

106

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

108

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

109

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-connect-to-new-challenge" title="tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge ()">tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge</a>

110

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

111

<code>tp_cli_channel_interface_sasl_authentication_signal_callback_new_challenge callback</code>,

112

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

113

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

114

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>,

115

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

116

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-connect-to-sasl-status-changed" title="tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed ()">tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed</a>

117

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

118

<code>tp_cli_channel_interface_sasl_authentication_signal_callback_sasl_status_changed callback</code>,

119

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

120

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

121

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>,

122

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

123

124

125

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_call_answer_captchas ()">tp_cli_channel_interface_captcha_authentication_call_answer_captchas</a>

126

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

127

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

128

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *in_Answers</code>,

129

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()">tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas</a> callback</code>,

130

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

131

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

132

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

133

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_call_cancel_captcha ()">tp_cli_channel_interface_captcha_authentication_call_cancel_captcha</a>

134

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

135

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

136

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_Reason</code>,

137

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Debug_Message</code>,

138

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()">tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha</a> callback</code>,

139

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

140

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

141

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

142

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_call_get_captcha_data ()">tp_cli_channel_interface_captcha_authentication_call_get_captcha_data</a>

143

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

144

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

145

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_ID</code>,

146

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mime_Type</code>,

147

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()">tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data</a> callback</code>,

148

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

149

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

150

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

151

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-call-get-captchas" title="tp_cli_channel_interface_captcha_authentication_call_get_captchas ()">tp_cli_channel_interface_captcha_authentication_call_get_captchas</a>

152

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

153

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

154

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()">tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas</a> callback</code>,

155

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

156

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

157

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

158

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()">*tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas</a>)

159

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

160

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

161

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

162

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

163

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()">*tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha</a>)

164

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

165

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

166

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

167

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

168

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()">*tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data</a>)

169

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

170

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *out_Captcha_Data</code>,

171

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

172

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

173

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

174

void (<a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()">*tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas</a>)

175

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

176

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *out_Captcha_Info</code>,

177

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> out_Number_Required</code>,

178

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *out_Language</code>,

179

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

180

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

181

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);

214

182

</pre>

215

183

</div>

216

184

217

185

<a name="telepathy-glib-channel-auth.description"></a><h2>Description</h2>

218

The ServerAuthentication channel type represents a request for client/UI

186

187

The ServerAuthentication channel type represents a request for client/UI

219

188

processes to carry out authentication with a server, including password

220

189

authentication (prove that you are who you say you are) and captcha

221

authentication (prove that you are not a bot).

222

</div>

223

224

<a name="telepathy-glib-channel-auth.functions_details"></a><h2>Functions</h2>

225

226

<a name="tp-cli-channel-interface-sasl-authentication-call-abort-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_call_abort_sasl ()</h3>

227

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

228

tp_cli_channel_interface_sasl_authentication_call_abort_sasl

229

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

230

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

231

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_Reason</code>,

232

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Debug_Message</code>,

233

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()">tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl</a> callback</code>,

234

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

235

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

236

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

237

Start a AbortSASL method call.

238

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Abort the current authentication try. If the current status is SASL_Status_Server_Failed or SASL_Status_Client_Failed, this method returns successfully, but has no further effect. If the current status is SASL_Status_Succeeded or SASL_Status_Client_Accepted then NotAvailable is raised. Otherwise, it changes the channel's state to SASL_Status_Client_Failed, with an appropriate error name and reason code.

239

240

<a name="id-1.4.37.7.2.6"></a><h4>Parameters</h4>

241

242

243

244

245

246

</colgroup>

247

<tbody>

248

<tr>

249

<td class="parameter_name">proxy</td>

250

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

251

252

</tr>

253

<tr>

254

<td class="parameter_name">timeout_ms</td>

255

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

256

default</td>

257

258

</tr>

259

<tr>

260

<td class="parameter_name">in_Reason</td>

261

<td class="parameter_description">Used to pass an 'in' argument: Reason for abort. (<a class="link" href="telepathy-glib-enums.html#TpSASLAbortReason" title="enum TpSASLAbortReason">TpSASLAbortReason</a>)</td>

262

263

</tr>

264

<tr>

265

<td class="parameter_name">in_Debug_Message</td>

266

<td class="parameter_description">Used to pass an 'in' argument: Debug message for abort.</td>

267

268

</tr>

269

<tr>

270

<td class="parameter_name">callback</td>

271

<td class="parameter_description">called when the method call succeeds or fails;

272

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

273

reply tracking</td>

274

275

</tr>

276

<tr>

277

278

<td class="parameter_description">user-supplied data passed to the callback;

279

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

280

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

281

282

</tr>

283

<tr>

284

<td class="parameter_name">destroy</td>

285

<td class="parameter_description">called with the user_data as argument, after the

286

call has succeeded, failed or been cancelled;

287

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

288

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

289

290

</tr>

291

<tr>

292

<td class="parameter_name">weak_object</td>

293

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

294

weakly referenced; if it is destroyed, this call

295

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

296

<code>callback</code>

297

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

298

299

</tr>

300

</tbody>

301

</table></div>

302

</div>

303

304

<a name="id-1.4.37.7.2.7"></a><h4>Returns</h4>

305

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

306

progress. It is borrowed from the object, and will become

307

invalid when the callback is called, the call is

308

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

309

310

</div>

311

</div>

312

<hr>

313

314

<a name="tp-cli-channel-interface-sasl-authentication-call-accept-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_call_accept_sasl ()</h3>

315

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

316

tp_cli_channel_interface_sasl_authentication_call_accept_sasl

317

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

318

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

319

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()">tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl</a> callback</code>,

320

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

321

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

322

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

323

Start a AcceptSASL method call.

324

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> If the channel's status is SASL_Status_Server_Succeeded, this method confirms successful authentication and advances the status of the channel to SASL_Status_Succeeded. If the channel's status is SASL_Status_In_Progress, calling this method indicates that the last <tp:member-ref>NewChallenge</tp:member-ref> signal was in fact additional data sent after a successful SASL negotiation, and declares that from the client's point of view, authentication was successful. This advances the state of the channel to SASL_Status_Client_Accepted. In mechanisms where the server authenticates itself to the client, calling this method indicates that the client considers this to have been successful. In the case of <tp:dbus-ref namespace="ofdT.Channel.Type">ServerAuthentication</tp:dbus-ref> channels, this means that the connection manager MAY continue to connect, and MAY advance the <tp:dbus-ref namespace="ofdT">Connection.Status</tp:dbus-ref> to Connected.

325

326

<a name="id-1.4.37.7.3.6"></a><h4>Parameters</h4>

327

328

329

330

331

332

</colgroup>

333

<tbody>

334

<tr>

335

<td class="parameter_name">proxy</td>

336

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

337

338

</tr>

339

<tr>

340

<td class="parameter_name">timeout_ms</td>

341

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

342

default</td>

343

344

</tr>

345

<tr>

346

<td class="parameter_name">callback</td>

347

<td class="parameter_description">called when the method call succeeds or fails;

348

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

349

reply tracking</td>

350

351

</tr>

352

<tr>

353

354

<td class="parameter_description">user-supplied data passed to the callback;

355

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

356

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

357

358

</tr>

359

<tr>

360

<td class="parameter_name">destroy</td>

361

<td class="parameter_description">called with the user_data as argument, after the

362

call has succeeded, failed or been cancelled;

363

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

364

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

365

366

</tr>

367

<tr>

368

<td class="parameter_name">weak_object</td>

369

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

370

weakly referenced; if it is destroyed, this call

371

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

372

<code>callback</code>

373

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

374

375

</tr>

376

</tbody>

377

</table></div>

378

</div>

379

380

<a name="id-1.4.37.7.3.7"></a><h4>Returns</h4>

381

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

382

progress. It is borrowed from the object, and will become

383

invalid when the callback is called, the call is

384

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

385

386

</div>

387

</div>

388

<hr>

389

390

<a name="tp-cli-channel-interface-sasl-authentication-call-respond"></a><h3>tp_cli_channel_interface_sasl_authentication_call_respond ()</h3>

391

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

392

tp_cli_channel_interface_sasl_authentication_call_respond

393

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

394

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

395

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Response_Data</code>,

396

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-respond" title="tp_cli_channel_interface_sasl_authentication_callback_for_respond ()">tp_cli_channel_interface_sasl_authentication_callback_for_respond</a> callback</code>,

397

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

398

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

399

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

400

Start a Respond method call.

401

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Send a response to the the last challenge received via <tp:member-ref>NewChallenge</tp:member-ref>.

402

403

<a name="id-1.4.37.7.4.6"></a><h4>Parameters</h4>

404

405

406

407

408

409

</colgroup>

410

<tbody>

411

<tr>

412

<td class="parameter_name">proxy</td>

413

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

414

415

</tr>

416

<tr>

417

<td class="parameter_name">timeout_ms</td>

418

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

419

default</td>

420

421

</tr>

422

<tr>

423

<td class="parameter_name">in_Response_Data</td>

424

<td class="parameter_description">Used to pass an 'in' argument: The response data.</td>

425

426

</tr>

427

<tr>

428

<td class="parameter_name">callback</td>

429

<td class="parameter_description">called when the method call succeeds or fails;

430

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

431

reply tracking</td>

432

433

</tr>

434

<tr>

435

436

<td class="parameter_description">user-supplied data passed to the callback;

437

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

438

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

439

440

</tr>

441

<tr>

442

<td class="parameter_name">destroy</td>

443

<td class="parameter_description">called with the user_data as argument, after the

444

call has succeeded, failed or been cancelled;

445

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

446

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

447

448

</tr>

449

<tr>

450

<td class="parameter_name">weak_object</td>

451

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

452

weakly referenced; if it is destroyed, this call

453

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

454

<code>callback</code>

455

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

456

457

</tr>

458

</tbody>

459

</table></div>

460

</div>

461

462

<a name="id-1.4.37.7.4.7"></a><h4>Returns</h4>

463

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

464

progress. It is borrowed from the object, and will become

465

invalid when the callback is called, the call is

466

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

467

468

</div>

469

</div>

470

<hr>

471

472

<a name="tp-cli-channel-interface-sasl-authentication-call-start-mechanism"></a><h3>tp_cli_channel_interface_sasl_authentication_call_start_mechanism ()</h3>

473

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

474

tp_cli_channel_interface_sasl_authentication_call_start_mechanism

475

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

476

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

477

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mechanism</code>,

478

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism</a> callback</code>,

479

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

480

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

481

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

482

Start a StartMechanism method call.

483

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Start an authentication try using <var>Mechanism</var>, without sending initial data (an &quot;initial response&quot; as defined in RFC 4422). <tp:rationale> This method is appropriate for mechanisms where the client cannot send anything until it receives a challenge from the server, such as <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code> in &quot;initial authentication&quot; mode. </tp:rationale>

484

485

<a name="id-1.4.37.7.5.6"></a><h4>Parameters</h4>

486

487

488

489

490

491

</colgroup>

492

<tbody>

493

<tr>

494

<td class="parameter_name">proxy</td>

495

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

496

497

</tr>

498

<tr>

499

<td class="parameter_name">timeout_ms</td>

500

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

501

default</td>

502

503

</tr>

504

<tr>

505

<td class="parameter_name">in_Mechanism</td>

506

<td class="parameter_description">Used to pass an 'in' argument: The chosen mechanism.</td>

507

508

</tr>

509

<tr>

510

<td class="parameter_name">callback</td>

511

<td class="parameter_description">called when the method call succeeds or fails;

512

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

513

reply tracking</td>

514

515

</tr>

516

<tr>

517

518

<td class="parameter_description">user-supplied data passed to the callback;

519

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

520

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

521

522

</tr>

523

<tr>

524

<td class="parameter_name">destroy</td>

525

<td class="parameter_description">called with the user_data as argument, after the

526

call has succeeded, failed or been cancelled;

527

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

528

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

529

530

</tr>

531

<tr>

532

<td class="parameter_name">weak_object</td>

533

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

534

weakly referenced; if it is destroyed, this call

535

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

536

<code>callback</code>

537

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

538

539

</tr>

540

</tbody>

541

</table></div>

542

</div>

543

544

<a name="id-1.4.37.7.5.7"></a><h4>Returns</h4>

545

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

546

progress. It is borrowed from the object, and will become

547

invalid when the callback is called, the call is

548

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

549

550

</div>

551

</div>

552

<hr>

553

554

<a name="tp-cli-channel-interface-sasl-authentication-call-start-mechanism-with-data"></a><h3>tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data ()</h3>

555

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

556

tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data

557

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

558

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

559

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mechanism</code>,

560

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Initial_Data</code>,

561

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data</a> callback</code>,

562

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

563

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

564

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

565

Start a StartMechanismWithData method call.

566

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Start an authentication try using <var>Mechanism</var>, and send <var>Initial_Data</var> as the &quot;initial response&quot; defined in <a href="http://tools.ietf.org/html/rfc4422section-3.3">RFC 4422 §3.3</a>. <tp:rationale> This method is appropriate for mechanisms where the client may send data first, such as <code>PLAIN</code>, or must send data first, such as <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code> in &quot;subsequent authentication&quot; mode. Having two methods allows any mechanism where it makes a difference to distinguish between the absence of an initial response (<tp:member-ref>StartMechanism</tp:member-ref>) and a zero-byte initial response (StartMechanismWithData, with Initial_Data empty). </tp:rationale> If the <tp:member-ref>HasInitialData</tp:member-ref> property is false, this indicates that the underlying protocol does not make it possible to send initial data. In such protocols, this method may only be used for the <code>X-TELEPATHY-</code> pseudo-mechanisms (such as <code>X-TELEPATHY-PASSWORD</code>), and will fail if used with an ordinary SASL mechanism. <tp:rationale> For instance, the IRC SASL extension implemented in Charybdis and Atheme does not support initial data - the first message in the exchange only carries the mechanism. This is significant if using <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code>, which cannot be used in the faster &quot;subsequent authentication&quot; mode on a protocol not supporting initial data. </tp:rationale>

567

568

<a name="id-1.4.37.7.6.6"></a><h4>Parameters</h4>

569

570

571

572

573

574

</colgroup>

575

<tbody>

576

<tr>

577

<td class="parameter_name">proxy</td>

578

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

579

580

</tr>

581

<tr>

582

<td class="parameter_name">timeout_ms</td>

583

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

584

default</td>

585

586

</tr>

587

<tr>

588

<td class="parameter_name">in_Mechanism</td>

589

<td class="parameter_description">Used to pass an 'in' argument: The chosen mechanism.</td>

590

591

</tr>

592

<tr>

593

<td class="parameter_name">in_Initial_Data</td>

594

<td class="parameter_description">Used to pass an 'in' argument: Initial data (an &quot;initial response&quot; in RFC 4422's terminology) to send with the mechanism.</td>

595

596

</tr>

597

<tr>

598

<td class="parameter_name">callback</td>

599

<td class="parameter_description">called when the method call succeeds or fails;

600

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

601

reply tracking</td>

602

603

</tr>

604

<tr>

605

606

<td class="parameter_description">user-supplied data passed to the callback;

607

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

608

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

609

610

</tr>

611

<tr>

612

<td class="parameter_name">destroy</td>

613

<td class="parameter_description">called with the user_data as argument, after the

614

call has succeeded, failed or been cancelled;

615

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

616

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

617

618

</tr>

619

<tr>

620

<td class="parameter_name">weak_object</td>

621

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

622

weakly referenced; if it is destroyed, this call

623

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

624

<code>callback</code>

625

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

626

627

</tr>

628

</tbody>

629

</table></div>

630

</div>

631

632

<a name="id-1.4.37.7.6.7"></a><h4>Returns</h4>

633

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

634

progress. It is borrowed from the object, and will become

635

invalid when the callback is called, the call is

636

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

637

638

</div>

639

</div>

640

<hr>

641

642

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()</h3>

643

<pre class="programlisting">void

644

(*tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl)

645

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

646

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

647

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

648

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

649

<div class="warning"><code class="literal">tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl</code> is deprecated and should not be used in newly-written code.</div>

650

Signature of the callback called when a AbortSASL method call

651

succeeds or fails.

652

653

<a name="id-1.4.37.7.7.6"></a><h4>Parameters</h4>

654

655

656

657

658

659

</colgroup>

660

<tbody>

661

<tr>

662

<td class="parameter_name">proxy</td>

663

<td class="parameter_description">the proxy on which the call was made</td>

664

665

</tr>

666

<tr>

667

<td class="parameter_name">error</td>

668

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

669

670

</tr>

671

<tr>

672

673

<td class="parameter_description">user-supplied data</td>

674

675

</tr>

676

<tr>

677

<td class="parameter_name">weak_object</td>

678

<td class="parameter_description">user-supplied object</td>

679

680

</tr>

681

</tbody>

682

</table></div>

683

</div>

684

</div>

685

<hr>

686

687

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()</h3>

688

<pre class="programlisting">void

689

(*tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl)

690

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

691

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

692

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

693

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

694

<div class="warning"><code class="literal">tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl</code> is deprecated and should not be used in newly-written code.</div>

695

Signature of the callback called when a AcceptSASL method call

696

succeeds or fails.

697

698

<a name="id-1.4.37.7.8.6"></a><h4>Parameters</h4>

699

700

701

702

703

704

</colgroup>

705

<tbody>

706

<tr>

707

<td class="parameter_name">proxy</td>

708

<td class="parameter_description">the proxy on which the call was made</td>

709

710

</tr>

711

<tr>

712

<td class="parameter_name">error</td>

713

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

714

715

</tr>

716

<tr>

717

718

<td class="parameter_description">user-supplied data</td>

719

720

</tr>

721

<tr>

722

<td class="parameter_name">weak_object</td>

723

<td class="parameter_description">user-supplied object</td>

724

725

</tr>

726

</tbody>

727

</table></div>

728

</div>

729

</div>

730

<hr>

731

732

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-respond"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_respond ()</h3>

733

<pre class="programlisting">void

734

(*tp_cli_channel_interface_sasl_authentication_callback_for_respond)

735

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

736

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

737

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

738

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

739

<div class="warning"><code class="literal">tp_cli_channel_interface_sasl_authentication_callback_for_respond</code> is deprecated and should not be used in newly-written code.</div>

740

Signature of the callback called when a Respond method call

741

succeeds or fails.

742

743

<a name="id-1.4.37.7.9.6"></a><h4>Parameters</h4>

744

745

746

747

748

749

</colgroup>

750

<tbody>

751

<tr>

752

<td class="parameter_name">proxy</td>

753

<td class="parameter_description">the proxy on which the call was made</td>

754

755

</tr>

756

<tr>

757

<td class="parameter_name">error</td>

758

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

759

760

</tr>

761

<tr>

762

763

<td class="parameter_description">user-supplied data</td>

764

765

</tr>

766

<tr>

767

<td class="parameter_name">weak_object</td>

768

<td class="parameter_description">user-supplied object</td>

769

770

</tr>

771

</tbody>

772

</table></div>

773

</div>

774

</div>

775

<hr>

776

777

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()</h3>

778

<pre class="programlisting">void

779

(*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism)

780

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

781

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

782

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

783

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

784

Signature of the callback called when a StartMechanism method call

785

succeeds or fails.

786

787

<a name="id-1.4.37.7.10.5"></a><h4>Parameters</h4>

788

789

790

791

792

793

</colgroup>

794

<tbody>

795

<tr>

796

<td class="parameter_name">proxy</td>

797

<td class="parameter_description">the proxy on which the call was made</td>

798

799

</tr>

800

<tr>

801

<td class="parameter_name">error</td>

802

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

803

804

</tr>

805

<tr>

806

807

<td class="parameter_description">user-supplied data</td>

808

809

</tr>

810

<tr>

811

<td class="parameter_name">weak_object</td>

812

<td class="parameter_description">user-supplied object</td>

813

814

</tr>

815

</tbody>

816

</table></div>

817

</div>

818

</div>

819

<hr>

820

821

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()</h3>

822

<pre class="programlisting">void

823

(*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data)

824

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

825

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

826

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

827

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

828

<div class="warning"><code class="literal">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data</code> is deprecated and should not be used in newly-written code.</div>

829

Signature of the callback called when a StartMechanismWithData method call

830

succeeds or fails.

831

832

<a name="id-1.4.37.7.11.6"></a><h4>Parameters</h4>

833

834

835

836

837

838

</colgroup>

839

<tbody>

840

<tr>

841

<td class="parameter_name">proxy</td>

842

<td class="parameter_description">the proxy on which the call was made</td>

843

844

</tr>

845

<tr>

846

<td class="parameter_name">error</td>

847

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

848

849

</tr>

850

<tr>

851

852

<td class="parameter_description">user-supplied data</td>

853

854

</tr>

855

<tr>

856

<td class="parameter_name">weak_object</td>

857

<td class="parameter_description">user-supplied object</td>

858

859

</tr>

860

</tbody>

861

</table></div>

862

</div>

863

</div>

864

<hr>

865

866

<a name="tp-cli-channel-interface-sasl-authentication-connect-to-new-challenge"></a><h3>tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge ()</h3>

867

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> *

868

tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge

869

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

870

<code>tp_cli_channel_interface_sasl_authentication_signal_callback_new_challenge callback</code>,

871

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

872

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

873

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>,

874

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

875

Connect a handler to the signal NewChallenge.

876

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when a new challenge is received from the server, or when a message indicating successful authentication and containing additional data is received from the server. When the channel's handler is ready to proceed, it should respond to the challenge by calling <tp:member-ref>Respond</tp:member-ref>, or respond to the additional data by calling <tp:member-ref>AcceptSASL</tp:member-ref>. Alternatively, it may call <tp:member-ref>AbortSASL</tp:member-ref> to abort authentication.

877

878

<a name="id-1.4.37.7.12.6"></a><h4>Parameters</h4>

879

880

881

882

883

884

</colgroup>

885

<tbody>

886

<tr>

887

<td class="parameter_name">proxy</td>

888

<td class="parameter_description">A <a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> or subclass</td>

889

890

</tr>

891

<tr>

892

<td class="parameter_name">callback</td>

893

<td class="parameter_description">Callback to be called when the signal is

894

received</td>

895

896

</tr>

897

<tr>

898

899

<td class="parameter_description">User-supplied data for the callback</td>

900

901

</tr>

902

<tr>

903

<td class="parameter_name">destroy</td>

904

<td class="parameter_description">Destructor for the user-supplied data, which

905

will be called when this signal is disconnected, or

906

before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

907

908

</tr>

909

<tr>

910

<td class="parameter_name">weak_object</td>

911

<td class="parameter_description">A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be weakly referenced;

912

if it is destroyed, this callback will automatically be

913

disconnected</td>

914

915

</tr>

916

<tr>

917

<td class="parameter_name">error</td>

918

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is

919

returned</td>

920

921

</tr>

922

</tbody>

923

</table></div>

924

</div>

925

926

<a name="id-1.4.37.7.12.7"></a><h4>Returns</h4>

927

a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> containing all of the

928

above, which can be used to disconnect the signal; or

929

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface

930

or has become invalid.

931

932

</div>

933

</div>

934

<hr>

935

936

<a name="tp-cli-channel-interface-sasl-authentication-connect-to-sasl-status-changed"></a><h3>tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed ()</h3>

937

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> *

938

tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed

939

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

940

<code>tp_cli_channel_interface_sasl_authentication_signal_callback_sasl_status_changed callback</code>,

941

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

942

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

943

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>,

944

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

945

Connect a handler to the signal SASLStatusChanged.

946

Emitted when the status of the channel changes.

947

948

<a name="id-1.4.37.7.13.6"></a><h4>Parameters</h4>

949

950

951

952

953

954

</colgroup>

955

<tbody>

956

<tr>

957

<td class="parameter_name">proxy</td>

958

<td class="parameter_description">A <a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> or subclass</td>

959

960

</tr>

961

<tr>

962

<td class="parameter_name">callback</td>

963

<td class="parameter_description">Callback to be called when the signal is

964

received</td>

965

966

</tr>

967

<tr>

968

969

<td class="parameter_description">User-supplied data for the callback</td>

970

971

</tr>

972

<tr>

973

<td class="parameter_name">destroy</td>

974

<td class="parameter_description">Destructor for the user-supplied data, which

975

will be called when this signal is disconnected, or

976

before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

977

978

</tr>

979

<tr>

980

<td class="parameter_name">weak_object</td>

981

<td class="parameter_description">A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be weakly referenced;

982

if it is destroyed, this callback will automatically be

983

disconnected</td>

984

985

</tr>

986

<tr>

987

<td class="parameter_name">error</td>

988

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is

989

returned</td>

990

991

</tr>

992

</tbody>

993

</table></div>

994

</div>

995

996

<a name="id-1.4.37.7.13.7"></a><h4>Returns</h4>

997

a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> containing all of the

998

above, which can be used to disconnect the signal; or

999

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface

1000

or has become invalid.

1001

1002

</div>

1003

</div>

1004

<hr>

1005

1006

<a name="tp-cli-channel-interface-captcha-authentication-call-answer-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_call_answer_captchas ()</h3>

1007

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

1008

tp_cli_channel_interface_captcha_authentication_call_answer_captchas

1009

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1010

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

1011

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *in_Answers</code>,

1012

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()">tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas</a> callback</code>,

1013

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1014

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

1015

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1016

Start a AnswerCaptchas method call.

1017

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Answer as many captchas as desired and/or required. Callable in state Local_Pending only. State changes to Remote_Pending.

1018

1019

<a name="id-1.4.37.7.14.6"></a><h4>Parameters</h4>

1020

1021

1022

1023

1024

1025

</colgroup>

1026

<tbody>

1027

<tr>

1028

<td class="parameter_name">proxy</td>

1029

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

1030

1031

</tr>

1032

<tr>

1033

<td class="parameter_name">timeout_ms</td>

1034

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

1035

default</td>

1036

1037

</tr>

1038

<tr>

1039

<td class="parameter_name">in_Answers</td>

1040

<td class="parameter_description">Used to pass an 'in' argument: The mapping of captcha IDs to answer strings.</td>

1041

1042

</tr>

1043

<tr>

1044

<td class="parameter_name">callback</td>

1045

<td class="parameter_description">called when the method call succeeds or fails;

1046

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1047

reply tracking</td>

1048

1049

</tr>

1050

<tr>

1051

1052

<td class="parameter_description">user-supplied data passed to the callback;

1053

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1054

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1055

1056

</tr>

1057

<tr>

1058

<td class="parameter_name">destroy</td>

1059

<td class="parameter_description">called with the user_data as argument, after the

1060

call has succeeded, failed or been cancelled;

1061

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1062

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1063

1064

</tr>

1065

<tr>

1066

<td class="parameter_name">weak_object</td>

1067

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1068

weakly referenced; if it is destroyed, this call

1069

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1070

<code>callback</code>

1071

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1072

1073

</tr>

1074

</tbody>

1075

</table></div>

1076

</div>

1077

1078

<a name="id-1.4.37.7.14.7"></a><h4>Returns</h4>

1079

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1080

progress. It is borrowed from the object, and will become

1081

invalid when the callback is called, the call is

1082

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

1083

1084

</div>

1085

</div>

1086

<hr>

1087

1088

<a name="tp-cli-channel-interface-captcha-authentication-call-cancel-captcha"></a><h3>tp_cli_channel_interface_captcha_authentication_call_cancel_captcha ()</h3>

1089

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

1090

tp_cli_channel_interface_captcha_authentication_call_cancel_captcha

1091

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1092

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

1093

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_Reason</code>,

1094

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Debug_Message</code>,

1095

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()">tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha</a> callback</code>,

1096

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1097

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

1098

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1099

Start a CancelCaptcha method call.

1100

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Cancel. State changes to Failed with error NotAvailable or Cancelled if it isn't already Failed. All you can do now is to close the channel.

1101

1102

<a name="id-1.4.37.7.15.6"></a><h4>Parameters</h4>

1103

1104

1105

1106

1107

1108

</colgroup>

1109

<tbody>

1110

<tr>

1111

<td class="parameter_name">proxy</td>

1112

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

1113

1114

</tr>

1115

<tr>

1116

<td class="parameter_name">timeout_ms</td>

1117

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

1118

default</td>

1119

1120

</tr>

1121

<tr>

1122

<td class="parameter_name">in_Reason</td>

1123

<td class="parameter_description">Used to pass an 'in' argument: Reason for cancelling. This MAY be used to choose an error response to the remote server, and SHOULD also be reflected in the <tp:member-ref>CaptchaError</tp:member-ref>. (<a class="link" href="telepathy-glib-enums.html#TpCaptchaCancelReason" title="enum TpCaptchaCancelReason">TpCaptchaCancelReason</a>)</td>

1124

1125

</tr>

1126

<tr>

1127

<td class="parameter_name">in_Debug_Message</td>

1128

<td class="parameter_description">Used to pass an 'in' argument: A textual description of the reason for cancelling, supplied by the Handler. This message SHOULD NOT be sent to the remote server, but SHOULD be copied into the 'debug-message' field of the <tp:member-ref>CaptchaErrorDetails</tp:member-ref> and <tp:dbus-ref namespace="ofdT.Connection">ConnectionError</tp:dbus-ref>.</td>

1129

1130

</tr>

1131

<tr>

1132

<td class="parameter_name">callback</td>

1133

<td class="parameter_description">called when the method call succeeds or fails;

1134

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1135

reply tracking</td>

1136

1137

</tr>

1138

<tr>

1139

1140

<td class="parameter_description">user-supplied data passed to the callback;

1141

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1142

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1143

1144

</tr>

1145

<tr>

1146

<td class="parameter_name">destroy</td>

1147

<td class="parameter_description">called with the user_data as argument, after the

1148

call has succeeded, failed or been cancelled;

1149

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1150

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1151

1152

</tr>

1153

<tr>

1154

<td class="parameter_name">weak_object</td>

1155

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1156

weakly referenced; if it is destroyed, this call

1157

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1158

<code>callback</code>

1159

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1160

1161

</tr>

1162

</tbody>

1163

</table></div>

1164

</div>

1165

1166

<a name="id-1.4.37.7.15.7"></a><h4>Returns</h4>

1167

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1168

progress. It is borrowed from the object, and will become

1169

invalid when the callback is called, the call is

1170

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

1171

1172

</div>

1173

</div>

1174

<hr>

1175

1176

<a name="tp-cli-channel-interface-captcha-authentication-call-get-captcha-data"></a><h3>tp_cli_channel_interface_captcha_authentication_call_get_captcha_data ()</h3>

1177

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

1178

tp_cli_channel_interface_captcha_authentication_call_get_captcha_data

1179

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1180

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

1181

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_ID</code>,

1182

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mime_Type</code>,

1183

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()">tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data</a> callback</code>,

1184

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1185

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

1186

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1187

Start a GetCaptchaData method call.

1188

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Fetch and return the captcha data. In protocols where captchas are downloaded out-of-band (for instance via HTTP), the connection manager is expected to do so. Returns an empty array if the type was &quot;qa&quot; <tp:rationale> If audio-based and image-based captchas are both available, we don't want to waste time downloading the audio until/unless the user asks to hear it. The extra D-Bus round-trips are not a problem, since they are expected to be quick compared with the time taken for the user to solve the captcha. </tp:rationale>

1189

1190

<a name="id-1.4.37.7.16.6"></a><h4>Parameters</h4>

1191

1192

1193

1194

1195

1196

</colgroup>

1197

<tbody>

1198

<tr>

1199

<td class="parameter_name">proxy</td>

1200

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

1201

1202

</tr>

1203

<tr>

1204

<td class="parameter_name">timeout_ms</td>

1205

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

1206

default</td>

1207

1208

</tr>

1209

<tr>

1210

1211

<td class="parameter_description">Used to pass an 'in' argument: The ID of the captcha of which to retrieve data.</td>

1212

1213

</tr>

1214

<tr>

1215

1216

<td class="parameter_description">Used to pass an 'in' argument: MIME type picked by the Handler, chosen from the list of MIME types received in <tp:member-ref>GetCaptchas</tp:member-ref>. <tp:rationale> XEP-0158 allows the same captcha to be made available in multiple formats, for instance the same spoken question as audio/x-wav, application/ogg and audio/speex. </tp:rationale></td>

1217

1218

</tr>

1219

<tr>

1220

<td class="parameter_name">callback</td>

1221

<td class="parameter_description">called when the method call succeeds or fails;

1222

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1223

reply tracking</td>

1224

1225

</tr>

1226

<tr>

1227

1228

<td class="parameter_description">user-supplied data passed to the callback;

1229

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1230

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1231

1232

</tr>

1233

<tr>

1234

<td class="parameter_name">destroy</td>

1235

<td class="parameter_description">called with the user_data as argument, after the

1236

call has succeeded, failed or been cancelled;

1237

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1238

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1239

1240

</tr>

1241

<tr>

1242

<td class="parameter_name">weak_object</td>

1243

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1244

weakly referenced; if it is destroyed, this call

1245

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1246

<code>callback</code>

1247

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1248

1249

</tr>

1250

</tbody>

1251

</table></div>

1252

</div>

1253

1254

<a name="id-1.4.37.7.16.7"></a><h4>Returns</h4>

1255

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1256

progress. It is borrowed from the object, and will become

1257

invalid when the callback is called, the call is

1258

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

1259

1260

</div>

1261

</div>

1262

<hr>

1263

1264

<a name="tp-cli-channel-interface-captcha-authentication-call-get-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_call_get_captchas ()</h3>

1265

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> *

1266

tp_cli_channel_interface_captcha_authentication_call_get_captchas

1267

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1268

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

1269

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()">tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas</a> callback</code>,

1270

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1271

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

1272

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1273

Start a GetCaptchas method call.

1274

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Gets information regarding each of the captcha methods available and which and how many need to be successfully answered To call this method successfully, the state must be Local_Pending or Try_Again. If it is Local_Pending, it remains Local_Pending. If called more than once while in Local_Pending state, or if the state is Try_Again, this method fetches a new set of captcha challenges, if possible, and the state returns to Local_Pending. <tp:rationale> For instance, you could call GetCaptchas again from Local_Pending state if the user indicates that they can't understand the initially-offered captcha. This is a method, not a property, so that it can be used to fetch more than one set of captcha challenges, and so that change notification is not required. Only the Handler should call this method and calling GetAll would not reduce round-trips, so the usual reasons to prefer a property do not apply here. </tp:rationale>

1275

1276

<a name="id-1.4.37.7.17.6"></a><h4>Parameters</h4>

1277

1278

1279

1280

1281

1282

</colgroup>

1283

<tbody>

1284

<tr>

1285

<td class="parameter_name">proxy</td>

1286

<td class="parameter_description">the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a></td>

1287

1288

</tr>

1289

<tr>

1290

<td class="parameter_name">timeout_ms</td>

1291

<td class="parameter_description">the timeout in milliseconds, or -1 to use the

1292

default</td>

1293

1294

</tr>

1295

<tr>

1296

<td class="parameter_name">callback</td>

1297

<td class="parameter_description">called when the method call succeeds or fails;

1298

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1299

reply tracking</td>

1300

1301

</tr>

1302

<tr>

1303

1304

<td class="parameter_description">user-supplied data passed to the callback;

1305

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1306

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1307

1308

</tr>

1309

<tr>

1310

<td class="parameter_name">destroy</td>

1311

<td class="parameter_description">called with the user_data as argument, after the

1312

call has succeeded, failed or been cancelled;

1313

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code>

1314

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1315

1316

</tr>

1317

<tr>

1318

<td class="parameter_name">weak_object</td>

1319

<td class="parameter_description">If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1320

weakly referenced; if it is destroyed, this call

1321

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1322

<code>callback</code>

1323

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1324

1325

</tr>

1326

</tbody>

1327

</table></div>

1328

</div>

1329

1330

<a name="id-1.4.37.7.17.7"></a><h4>Returns</h4>

1331

a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1332

progress. It is borrowed from the object, and will become

1333

invalid when the callback is called, the call is

1334

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.

1335

1336

</div>

1337

</div>

1338

<hr>

1339

1340

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()</h3>

1341

<pre class="programlisting">void

1342

(*tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas)

1343

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1344

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1345

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1346

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1347

Signature of the callback called when a AnswerCaptchas method call

1348

succeeds or fails.

1349

1350

<a name="id-1.4.37.7.18.5"></a><h4>Parameters</h4>

1351

1352

1353

1354

1355

1356

</colgroup>

1357

<tbody>

1358

<tr>

1359

<td class="parameter_name">proxy</td>

1360

<td class="parameter_description">the proxy on which the call was made</td>

1361

1362

</tr>

1363

<tr>

1364

<td class="parameter_name">error</td>

1365

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1366

1367

</tr>

1368

<tr>

1369

1370

<td class="parameter_description">user-supplied data</td>

1371

1372

</tr>

1373

<tr>

1374

<td class="parameter_name">weak_object</td>

1375

<td class="parameter_description">user-supplied object</td>

1376

1377

</tr>

1378

</tbody>

1379

</table></div>

1380

</div>

1381

</div>

1382

<hr>

1383

1384

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()</h3>

1385

<pre class="programlisting">void

1386

(*tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha)

1387

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1388

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1389

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1390

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1391

Signature of the callback called when a CancelCaptcha method call

1392

succeeds or fails.

1393

1394

<a name="id-1.4.37.7.19.5"></a><h4>Parameters</h4>

1395

1396

1397

1398

1399

1400

</colgroup>

1401

<tbody>

1402

<tr>

1403

<td class="parameter_name">proxy</td>

1404

<td class="parameter_description">the proxy on which the call was made</td>

1405

1406

</tr>

1407

<tr>

1408

<td class="parameter_name">error</td>

1409

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1410

1411

</tr>

1412

<tr>

1413

1414

<td class="parameter_description">user-supplied data</td>

1415

1416

</tr>

1417

<tr>

1418

<td class="parameter_name">weak_object</td>

1419

<td class="parameter_description">user-supplied object</td>

1420

1421

</tr>

1422

</tbody>

1423

</table></div>

1424

</div>

1425

</div>

1426

<hr>

1427

1428

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()</h3>

1429

<pre class="programlisting">void

1430

(*tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data)

1431

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1432

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *out_Captcha_Data</code>,

1433

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1434

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1435

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1436

Signature of the callback called when a GetCaptchaData method call

1437

succeeds or fails.

1438

1439

<a name="id-1.4.37.7.20.5"></a><h4>Parameters</h4>

1440

1441

1442

1443

1444

1445

</colgroup>

1446

<tbody>

1447

<tr>

1448

<td class="parameter_name">proxy</td>

1449

<td class="parameter_description">the proxy on which the call was made</td>

1450

1451

</tr>

1452

<tr>

1453

<td class="parameter_name">out_Captcha_Data</td>

1454

<td class="parameter_description">Used to return an 'out' argument if <code>error</code>

1455

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: Captcha data as requested.</td>

1456

1457

</tr>

1458

<tr>

1459

<td class="parameter_name">error</td>

1460

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1461

1462

</tr>

1463

<tr>

1464

1465

<td class="parameter_description">user-supplied data</td>

1466

1467

</tr>

1468

<tr>

1469

<td class="parameter_name">weak_object</td>

1470

<td class="parameter_description">user-supplied object</td>

1471

1472

</tr>

1473

</tbody>

1474

</table></div>

1475

</div>

1476

</div>

1477

<hr>

1478

1479

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()</h3>

1480

<pre class="programlisting">void

1481

(*tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas)

1482

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1483

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *out_Captcha_Info</code>,

1484

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> out_Number_Required</code>,

1485

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *out_Language</code>,

1486

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1487

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1488

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1489

<div class="warning"><code class="literal">tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas</code> is deprecated and should not be used in newly-written code.</div>

1490

Signature of the callback called when a GetCaptchas method call

1491

succeeds or fails.

1492

1493

<a name="id-1.4.37.7.21.6"></a><h4>Parameters</h4>

1494

1495

1496

1497

1498

1499

</colgroup>

1500

<tbody>

1501

<tr>

1502

<td class="parameter_name">proxy</td>

1503

<td class="parameter_description">the proxy on which the call was made</td>

1504

1505

</tr>

1506

<tr>

1507

<td class="parameter_name">out_Captcha_Info</td>

1508

<td class="parameter_description">Used to return an 'out' argument if <code>error</code>

1509

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Information about each of the available captcha methods.</td>

1510

1511

</tr>

1512

<tr>

1513

<td class="parameter_name">out_Number_Required</td>

1514

<td class="parameter_description">Used to return an 'out' argument if <code>error</code>

1515

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> The number of captcha methods required to be answered in order to successfully complete this captcha challenge (most frequently 1, but XMPP allows servers to demand that more than one captcha is answered).</td>

1516

1517

</tr>

1518

<tr>

1519

<td class="parameter_name">out_Language</td>

1520

<td class="parameter_description">Used to return an 'out' argument if <code>error</code>

1521

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> The language of each Label in Captcha_Info if available, for instance en_US, or &quot;&quot; if unknown.</td>

1522

1523

</tr>

1524

<tr>

1525

<td class="parameter_name">error</td>

1526

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1527

1528

</tr>

1529

<tr>

1530

1531

<td class="parameter_description">user-supplied data</td>

1532

1533

</tr>

1534

<tr>

1535

<td class="parameter_name">weak_object</td>

1536

<td class="parameter_description">user-supplied object</td>

1537

1538

</tr>

1539

</tbody>

1540

</table></div>

1541

</div>

1542

</div>

1543

</div>

1544

1545

<a name="telepathy-glib-channel-auth.other_details"></a><h2>Types and Values</h2>

190

authentication (prove that you are not a bot).

191

192

</div>

193

194

<a name="telepathy-glib-channel-auth.details"></a><h2>Details</h2>

195

196

<a name="tp-cli-channel-interface-sasl-authentication-call-abort-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_call_abort_sasl ()</h3>

197

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_sasl_authentication_call_abort_sasl

198

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

199

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

200

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_Reason</code>,

201

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Debug_Message</code>,

202

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()">tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl</a> callback</code>,

203

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

204

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

205

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

206

207

Start a AbortSASL method call.

208

209

210

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Abort the current authentication try. If the current status is SASL_Status_Server_Failed or SASL_Status_Client_Failed, this method returns successfully, but has no further effect. If the current status is SASL_Status_Succeeded or SASL_Status_Client_Accepted then NotAvailable is raised. Otherwise, it changes the channel's state to SASL_Status_Client_Failed, with an appropriate error name and reason code.

211

212

213

214

215

<col>

216

</colgroup>

217

<tbody>

218

<tr>

219

<td><code>proxy</code> :</td>

220

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

221

</td>

222

</tr>

223

<tr>

224

<td><code>timeout_ms</code> :</td>

225

<td>the timeout in milliseconds, or -1 to use the

226

default</td>

227

</tr>

228

<tr>

229

<td><code>in_Reason</code> :</td>

230

<td>Used to pass an 'in' argument: Reason for abort. (<a class="link" href="telepathy-glib-enums.html#TpSASLAbortReason" title="enum TpSASLAbortReason">TpSASLAbortReason</a>)</td>

231

</tr>

232

<tr>

233

<td><code>in_Debug_Message</code> :</td>

234

<td>Used to pass an 'in' argument: Debug message for abort.</td>

235

</tr>

236

<tr>

237

<td><code>callback</code> :</td>

238

<td>called when the method call succeeds or fails;

239

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

240

reply tracking</td>

241

</tr>

242

<tr>

243

244

<td>user-supplied data passed to the callback;

245

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

246

</td>

247

</tr>

248

<tr>

249

<td><code>destroy</code> :</td>

250

<td>called with the user_data as argument, after the

251

call has succeeded, failed or been cancelled;

252

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

253

</td>

254

</tr>

255

<tr>

256

<td><code>weak_object</code> :</td>

257

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

258

weakly referenced; if it is destroyed, this call

259

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

260

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

261

</td>

262

</tr>

263

<tr>

264

<td>Returns :</td>

265

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

266

progress. It is borrowed from the object, and will become

267

invalid when the callback is called, the call is

268

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

269

</tr>

270

</tbody>

271

</table></div>

272

</div>

273

<hr>

274

275

<a name="tp-cli-channel-interface-sasl-authentication-call-accept-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_call_accept_sasl ()</h3>

276

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_sasl_authentication_call_accept_sasl

277

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

278

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

279

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl" title="tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()">tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl</a> callback</code>,

280

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

281

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

282

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

283

284

Start a AcceptSASL method call.

285

286

287

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> If the channel's status is SASL_Status_Server_Succeeded, this method confirms successful authentication and advances the status of the channel to SASL_Status_Succeeded. If the channel's status is SASL_Status_In_Progress, calling this method indicates that the last <tp:member-ref>NewChallenge</tp:member-ref> signal was in fact additional data sent after a successful SASL negotiation, and declares that from the client's point of view, authentication was successful. This advances the state of the channel to SASL_Status_Client_Accepted. In mechanisms where the server authenticates itself to the client, calling this method indicates that the client considers this to have been successful. In the case of <tp:dbus-ref namespace="ofdT.Channel.Type">ServerAuthentication</tp:dbus-ref> channels, this means that the connection manager MAY continue to connect, and MAY advance the <tp:dbus-ref namespace="ofdT">Connection.Status</tp:dbus-ref> to Connected.

288

289

290

291

292

<col>

293

</colgroup>

294

<tbody>

295

<tr>

296

<td><code>proxy</code> :</td>

297

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

298

</td>

299

</tr>

300

<tr>

301

<td><code>timeout_ms</code> :</td>

302

<td>the timeout in milliseconds, or -1 to use the

303

default</td>

304

</tr>

305

<tr>

306

<td><code>callback</code> :</td>

307

<td>called when the method call succeeds or fails;

308

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

309

reply tracking</td>

310

</tr>

311

<tr>

312

313

<td>user-supplied data passed to the callback;

314

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

315

</td>

316

</tr>

317

<tr>

318

<td><code>destroy</code> :</td>

319

<td>called with the user_data as argument, after the

320

call has succeeded, failed or been cancelled;

321

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

322

</td>

323

</tr>

324

<tr>

325

<td><code>weak_object</code> :</td>

326

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

327

weakly referenced; if it is destroyed, this call

328

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

329

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

330

</td>

331

</tr>

332

<tr>

333

<td>Returns :</td>

334

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

335

progress. It is borrowed from the object, and will become

336

invalid when the callback is called, the call is

337

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

338

</tr>

339

</tbody>

340

</table></div>

341

</div>

342

<hr>

343

344

<a name="tp-cli-channel-interface-sasl-authentication-call-respond"></a><h3>tp_cli_channel_interface_sasl_authentication_call_respond ()</h3>

345

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_sasl_authentication_call_respond

346

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

347

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

348

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Response_Data</code>,

349

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-respond" title="tp_cli_channel_interface_sasl_authentication_callback_for_respond ()">tp_cli_channel_interface_sasl_authentication_callback_for_respond</a> callback</code>,

350

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

351

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

352

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

353

354

Start a Respond method call.

355

356

357

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Send a response to the the last challenge received via <tp:member-ref>NewChallenge</tp:member-ref>.

358

359

360

361

362

<col>

363

</colgroup>

364

<tbody>

365

<tr>

366

<td><code>proxy</code> :</td>

367

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

368

</td>

369

</tr>

370

<tr>

371

<td><code>timeout_ms</code> :</td>

372

<td>the timeout in milliseconds, or -1 to use the

373

default</td>

374

</tr>

375

<tr>

376

<td><code>in_Response_Data</code> :</td>

377

<td>Used to pass an 'in' argument: The response data.</td>

378

</tr>

379

<tr>

380

<td><code>callback</code> :</td>

381

<td>called when the method call succeeds or fails;

382

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

383

reply tracking</td>

384

</tr>

385

<tr>

386

387

<td>user-supplied data passed to the callback;

388

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

389

</td>

390

</tr>

391

<tr>

392

<td><code>destroy</code> :</td>

393

<td>called with the user_data as argument, after the

394

call has succeeded, failed or been cancelled;

395

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

396

</td>

397

</tr>

398

<tr>

399

<td><code>weak_object</code> :</td>

400

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

401

weakly referenced; if it is destroyed, this call

402

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

403

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

404

</td>

405

</tr>

406

<tr>

407

<td>Returns :</td>

408

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

409

progress. It is borrowed from the object, and will become

410

invalid when the callback is called, the call is

411

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

412

</tr>

413

</tbody>

414

</table></div>

415

</div>

416

<hr>

417

418

<a name="tp-cli-channel-interface-sasl-authentication-call-start-mechanism"></a><h3>tp_cli_channel_interface_sasl_authentication_call_start_mechanism ()</h3>

419

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_sasl_authentication_call_start_mechanism

420

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

421

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

422

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mechanism</code>,

423

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism</a> callback</code>,

424

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

425

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

426

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

427

428

Start a StartMechanism method call.

429

430

431

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Start an authentication try using <var>Mechanism</var>, without sending initial data (an &quot;initial response&quot; as defined in RFC 4422). <tp:rationale> This method is appropriate for mechanisms where the client cannot send anything until it receives a challenge from the server, such as <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code> in &quot;initial authentication&quot; mode. </tp:rationale>

432

433

434

435

436

<col>

437

</colgroup>

438

<tbody>

439

<tr>

440

<td><code>proxy</code> :</td>

441

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

442

</td>

443

</tr>

444

<tr>

445

<td><code>timeout_ms</code> :</td>

446

<td>the timeout in milliseconds, or -1 to use the

447

default</td>

448

</tr>

449

<tr>

450

<td><code>in_Mechanism</code> :</td>

451

<td>Used to pass an 'in' argument: The chosen mechanism.</td>

452

</tr>

453

<tr>

454

<td><code>callback</code> :</td>

455

<td>called when the method call succeeds or fails;

456

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

457

reply tracking</td>

458

</tr>

459

<tr>

460

461

<td>user-supplied data passed to the callback;

462

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

463

</td>

464

</tr>

465

<tr>

466

<td><code>destroy</code> :</td>

467

<td>called with the user_data as argument, after the

468

call has succeeded, failed or been cancelled;

469

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

470

</td>

471

</tr>

472

<tr>

473

<td><code>weak_object</code> :</td>

474

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

475

weakly referenced; if it is destroyed, this call

476

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

477

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

478

</td>

479

</tr>

480

<tr>

481

<td>Returns :</td>

482

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

483

progress. It is borrowed from the object, and will become

484

invalid when the callback is called, the call is

485

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

486

</tr>

487

</tbody>

488

</table></div>

489

</div>

490

<hr>

491

492

<a name="tp-cli-channel-interface-sasl-authentication-call-start-mechanism-with-data"></a><h3>tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data ()</h3>

493

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_sasl_authentication_call_start_mechanism_with_data

494

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

495

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

496

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mechanism</code>,

497

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *in_Initial_Data</code>,

498

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data" title="tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()">tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data</a> callback</code>,

499

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

500

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

501

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

502

503

Start a StartMechanismWithData method call.

504

505

506

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Start an authentication try using <var>Mechanism</var>, and send <var>Initial_Data</var> as the &quot;initial response&quot; defined in <a href="http://tools.ietf.org/html/rfc4422section-3.3">RFC 4422 §3.3</a>. <tp:rationale> This method is appropriate for mechanisms where the client may send data first, such as <code>PLAIN</code>, or must send data first, such as <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code> in &quot;subsequent authentication&quot; mode. Having two methods allows any mechanism where it makes a difference to distinguish between the absence of an initial response (<tp:member-ref>StartMechanism</tp:member-ref>) and a zero-byte initial response (StartMechanismWithData, with Initial_Data empty). </tp:rationale> If the <tp:member-ref>HasInitialData</tp:member-ref> property is false, this indicates that the underlying protocol does not make it possible to send initial data. In such protocols, this method may only be used for the <code>X-TELEPATHY-</code> pseudo-mechanisms (such as <code>X-TELEPATHY-PASSWORD</code>), and will fail if used with an ordinary SASL mechanism. <tp:rationale> For instance, the IRC SASL extension implemented in Charybdis and Atheme does not support initial data - the first message in the exchange only carries the mechanism. This is significant if using <code><a href="http://tools.ietf.org/html/rfc2831">DIGEST-MD5</a></code>, which cannot be used in the faster &quot;subsequent authentication&quot; mode on a protocol not supporting initial data. </tp:rationale>

507

508

509

510

511

<col>

512

</colgroup>

513

<tbody>

514

<tr>

515

<td><code>proxy</code> :</td>

516

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

517

</td>

518

</tr>

519

<tr>

520

<td><code>timeout_ms</code> :</td>

521

<td>the timeout in milliseconds, or -1 to use the

522

default</td>

523

</tr>

524

<tr>

525

<td><code>in_Mechanism</code> :</td>

526

<td>Used to pass an 'in' argument: The chosen mechanism.</td>

527

</tr>

528

<tr>

529

<td><code>in_Initial_Data</code> :</td>

530

<td>Used to pass an 'in' argument: Initial data (an &quot;initial response&quot; in RFC 4422's terminology) to send with the mechanism.</td>

531

</tr>

532

<tr>

533

<td><code>callback</code> :</td>

534

<td>called when the method call succeeds or fails;

535

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

536

reply tracking</td>

537

</tr>

538

<tr>

539

540

<td>user-supplied data passed to the callback;

541

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

542

</td>

543

</tr>

544

<tr>

545

<td><code>destroy</code> :</td>

546

<td>called with the user_data as argument, after the

547

call has succeeded, failed or been cancelled;

548

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

549

</td>

550

</tr>

551

<tr>

552

<td><code>weak_object</code> :</td>

553

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

554

weakly referenced; if it is destroyed, this call

555

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

556

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

557

</td>

558

</tr>

559

<tr>

560

<td>Returns :</td>

561

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

562

progress. It is borrowed from the object, and will become

563

invalid when the callback is called, the call is

564

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

565

</tr>

566

</tbody>

567

</table></div>

568

</div>

569

<hr>

570

571

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-abort-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl ()</h3>

572

<pre class="programlisting">void (*tp_cli_channel_interface_sasl_authentication_callback_for_abort_sasl)

573

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

574

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

575

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

576

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

577

578

Signature of the callback called when a AbortSASL method call

579

succeeds or fails.

580

581

582

583

584

<col>

585

</colgroup>

586

<tbody>

587

<tr>

588

<td><code>proxy</code> :</td>

589

<td>the proxy on which the call was made</td>

590

</tr>

591

<tr>

592

<td><code>error</code> :</td>

593

<td>

594

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

595

</tr>

596

<tr>

597

598

<td>user-supplied data</td>

599

</tr>

600

<tr>

601

<td><code>weak_object</code> :</td>

602

<td>user-supplied object</td>

603

</tr>

604

</tbody>

605

</table></div>

606

</div>

607

<hr>

608

609

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-accept-sasl"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl ()</h3>

610

<pre class="programlisting">void (*tp_cli_channel_interface_sasl_authentication_callback_for_accept_sasl)

611

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

612

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

613

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

614

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

615

616

Signature of the callback called when a AcceptSASL method call

617

succeeds or fails.

618

619

620

621

622

<col>

623

</colgroup>

624

<tbody>

625

<tr>

626

<td><code>proxy</code> :</td>

627

<td>the proxy on which the call was made</td>

628

</tr>

629

<tr>

630

<td><code>error</code> :</td>

631

<td>

632

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

633

</tr>

634

<tr>

635

636

<td>user-supplied data</td>

637

</tr>

638

<tr>

639

<td><code>weak_object</code> :</td>

640

<td>user-supplied object</td>

641

</tr>

642

</tbody>

643

</table></div>

644

</div>

645

<hr>

646

647

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-respond"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_respond ()</h3>

648

<pre class="programlisting">void (*tp_cli_channel_interface_sasl_authentication_callback_for_respond)

649

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

650

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

651

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

652

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

653

654

Signature of the callback called when a Respond method call

655

succeeds or fails.

656

657

658

659

660

<col>

661

</colgroup>

662

<tbody>

663

<tr>

664

<td><code>proxy</code> :</td>

665

<td>the proxy on which the call was made</td>

666

</tr>

667

<tr>

668

<td><code>error</code> :</td>

669

<td>

670

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

671

</tr>

672

<tr>

673

674

<td>user-supplied data</td>

675

</tr>

676

<tr>

677

<td><code>weak_object</code> :</td>

678

<td>user-supplied object</td>

679

</tr>

680

</tbody>

681

</table></div>

682

</div>

683

<hr>

684

685

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism ()</h3>

686

<pre class="programlisting">void (*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism)

687

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

688

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

689

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

690

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

691

692

Signature of the callback called when a StartMechanism method call

693

succeeds or fails.

694

695

696

697

698

<col>

699

</colgroup>

700

<tbody>

701

<tr>

702

<td><code>proxy</code> :</td>

703

<td>the proxy on which the call was made</td>

704

</tr>

705

<tr>

706

<td><code>error</code> :</td>

707

<td>

708

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

709

</tr>

710

<tr>

711

712

<td>user-supplied data</td>

713

</tr>

714

<tr>

715

<td><code>weak_object</code> :</td>

716

<td>user-supplied object</td>

717

</tr>

718

</tbody>

719

</table></div>

720

</div>

721

<hr>

722

723

<a name="tp-cli-channel-interface-sasl-authentication-callback-for-start-mechanism-with-data"></a><h3>tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data ()</h3>

724

<pre class="programlisting">void (*tp_cli_channel_interface_sasl_authentication_callback_for_start_mechanism_with_data)

725

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

726

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

727

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

728

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

729

730

Signature of the callback called when a StartMechanismWithData method call

731

succeeds or fails.

732

733

734

735

736

<col>

737

</colgroup>

738

<tbody>

739

<tr>

740

<td><code>proxy</code> :</td>

741

<td>the proxy on which the call was made</td>

742

</tr>

743

<tr>

744

<td><code>error</code> :</td>

745

<td>

746

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

747

</tr>

748

<tr>

749

750

<td>user-supplied data</td>

751

</tr>

752

<tr>

753

<td><code>weak_object</code> :</td>

754

<td>user-supplied object</td>

755

</tr>

756

</tbody>

757

</table></div>

758

</div>

759

<hr>

760

761

<a name="tp-cli-channel-interface-sasl-authentication-connect-to-new-challenge"></a><h3>tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge ()</h3>

762

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_interface_sasl_authentication_connect_to_new_challenge

763

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

764

<code>tp_cli_channel_interface_sasl_authentication_signal_callback_new_challenge callback</code>,

765

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

766

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

767

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>,

768

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

769

770

Connect a handler to the signal NewChallenge.

771

772

773

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when a new challenge is received from the server, or when a message indicating successful authentication and containing additional data is received from the server. When the channel's handler is ready to proceed, it should respond to the challenge by calling <tp:member-ref>Respond</tp:member-ref>, or respond to the additional data by calling <tp:member-ref>AcceptSASL</tp:member-ref>. Alternatively, it may call <tp:member-ref>AbortSASL</tp:member-ref> to abort authentication.

774

775

776

777

778

<col>

779

</colgroup>

780

<tbody>

781

<tr>

782

<td><code>proxy</code> :</td>

783

<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> or subclass</td>

784

</tr>

785

<tr>

786

<td><code>callback</code> :</td>

787

<td>Callback to be called when the signal is

788

received</td>

789

</tr>

790

<tr>

791

792

<td>User-supplied data for the callback</td>

793

</tr>

794

<tr>

795

<td><code>destroy</code> :</td>

796

<td>Destructor for the user-supplied data, which

797

will be called when this signal is disconnected, or

798

before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

799

</td>

800

</tr>

801

<tr>

802

<td><code>weak_object</code> :</td>

803

<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be weakly referenced;

804

if it is destroyed, this callback will automatically be

805

disconnected</td>

806

</tr>

807

<tr>

808

<td><code>error</code> :</td>

809

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is

810

returned</td>

811

</tr>

812

<tr>

813

<td>Returns :</td>

814

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> containing all of the

815

above, which can be used to disconnect the signal; or

816

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface

817

or has become invalid.</td>

818

</tr>

819

</tbody>

820

</table></div>

821

</div>

822

<hr>

823

824

<a name="tp-cli-channel-interface-sasl-authentication-connect-to-sasl-status-changed"></a><h3>tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed ()</h3>

825

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_interface_sasl_authentication_connect_to_sasl_status_changed

826

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

827

<code>tp_cli_channel_interface_sasl_authentication_signal_callback_sasl_status_changed callback</code>,

828

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

829

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

830

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>,

831

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

832

833

Connect a handler to the signal SASLStatusChanged.

834

835

836

Emitted when the status of the channel changes.

837

838

839

840

841

<col>

842

</colgroup>

843

<tbody>

844

<tr>

845

<td><code>proxy</code> :</td>

846

<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> or subclass</td>

847

</tr>

848

<tr>

849

<td><code>callback</code> :</td>

850

<td>Callback to be called when the signal is

851

received</td>

852

</tr>

853

<tr>

854

855

<td>User-supplied data for the callback</td>

856

</tr>

857

<tr>

858

<td><code>destroy</code> :</td>

859

<td>Destructor for the user-supplied data, which

860

will be called when this signal is disconnected, or

861

before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

862

</td>

863

</tr>

864

<tr>

865

<td><code>weak_object</code> :</td>

866

<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be weakly referenced;

867

if it is destroyed, this callback will automatically be

868

disconnected</td>

869

</tr>

870

<tr>

871

<td><code>error</code> :</td>

872

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is

873

returned</td>

874

</tr>

875

<tr>

876

<td>Returns :</td>

877

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> containing all of the

878

above, which can be used to disconnect the signal; or

879

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface

880

or has become invalid.</td>

881

</tr>

882

</tbody>

883

</table></div>

884

</div>

885

<hr>

886

887

<a name="tp-cli-channel-interface-captcha-authentication-call-answer-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_call_answer_captchas ()</h3>

888

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_captcha_authentication_call_answer_captchas

889

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

890

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

891

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> *in_Answers</code>,

892

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()">tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas</a> callback</code>,

893

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

894

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

895

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

896

897

Start a AnswerCaptchas method call.

898

899

900

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Answer as many captchas as desired and/or required. Callable in state Local_Pending only. State changes to Remote_Pending.

901

902

903

904

905

<col>

906

</colgroup>

907

<tbody>

908

<tr>

909

<td><code>proxy</code> :</td>

910

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

911

</td>

912

</tr>

913

<tr>

914

<td><code>timeout_ms</code> :</td>

915

<td>the timeout in milliseconds, or -1 to use the

916

default</td>

917

</tr>

918

<tr>

919

<td><code>in_Answers</code> :</td>

920

<td>Used to pass an 'in' argument: The mapping of captcha IDs to answer strings.</td>

921

</tr>

922

<tr>

923

<td><code>callback</code> :</td>

924

<td>called when the method call succeeds or fails;

925

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

926

reply tracking</td>

927

</tr>

928

<tr>

929

930

<td>user-supplied data passed to the callback;

931

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

932

</td>

933

</tr>

934

<tr>

935

<td><code>destroy</code> :</td>

936

<td>called with the user_data as argument, after the

937

call has succeeded, failed or been cancelled;

938

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

939

</td>

940

</tr>

941

<tr>

942

<td><code>weak_object</code> :</td>

943

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

944

weakly referenced; if it is destroyed, this call

945

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

946

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

947

</td>

948

</tr>

949

<tr>

950

<td>Returns :</td>

951

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

952

progress. It is borrowed from the object, and will become

953

invalid when the callback is called, the call is

954

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

955

</tr>

956

</tbody>

957

</table></div>

958

</div>

959

<hr>

960

961

<a name="tp-cli-channel-interface-captcha-authentication-call-cancel-captcha"></a><h3>tp_cli_channel_interface_captcha_authentication_call_cancel_captcha ()</h3>

962

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_captcha_authentication_call_cancel_captcha

963

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

964

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

965

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_Reason</code>,

966

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Debug_Message</code>,

967

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha" title="tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()">tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha</a> callback</code>,

968

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

969

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

970

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

971

972

Start a CancelCaptcha method call.

973

974

975

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Cancel. State changes to Failed with error NotAvailable or Cancelled if it isn't already Failed. All you can do now is to close the channel.

976

977

978

979

980

<col>

981

</colgroup>

982

<tbody>

983

<tr>

984

<td><code>proxy</code> :</td>

985

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

986

</td>

987

</tr>

988

<tr>

989

<td><code>timeout_ms</code> :</td>

990

<td>the timeout in milliseconds, or -1 to use the

991

default</td>

992

</tr>

993

<tr>

994

<td><code>in_Reason</code> :</td>

995

<td>Used to pass an 'in' argument: Reason for cancelling. This MAY be used to choose an error response to the remote server, and SHOULD also be reflected in the <tp:member-ref>CaptchaError</tp:member-ref>. (<a class="link" href="telepathy-glib-enums.html#TpCaptchaCancelReason" title="enum TpCaptchaCancelReason">TpCaptchaCancelReason</a>)</td>

996

</tr>

997

<tr>

998

<td><code>in_Debug_Message</code> :</td>

999

<td>Used to pass an 'in' argument: A textual description of the reason for cancelling, supplied by the Handler. This message SHOULD NOT be sent to the remote server, but SHOULD be copied into the 'debug-message' field of the <tp:member-ref>CaptchaErrorDetails</tp:member-ref> and <tp:dbus-ref namespace="ofdT.Connection">ConnectionError</tp:dbus-ref>.</td>

1000

</tr>

1001

<tr>

1002

<td><code>callback</code> :</td>

1003

<td>called when the method call succeeds or fails;

1004

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1005

reply tracking</td>

1006

</tr>

1007

<tr>

1008

1009

<td>user-supplied data passed to the callback;

1010

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1011

</td>

1012

</tr>

1013

<tr>

1014

<td><code>destroy</code> :</td>

1015

<td>called with the user_data as argument, after the

1016

call has succeeded, failed or been cancelled;

1017

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1018

</td>

1019

</tr>

1020

<tr>

1021

<td><code>weak_object</code> :</td>

1022

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1023

weakly referenced; if it is destroyed, this call

1024

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1025

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1026

</td>

1027

</tr>

1028

<tr>

1029

<td>Returns :</td>

1030

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1031

progress. It is borrowed from the object, and will become

1032

invalid when the callback is called, the call is

1033

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

1034

</tr>

1035

</tbody>

1036

</table></div>

1037

</div>

1038

<hr>

1039

1040

<a name="tp-cli-channel-interface-captcha-authentication-call-get-captcha-data"></a><h3>tp_cli_channel_interface_captcha_authentication_call_get_captcha_data ()</h3>

1041

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_captcha_authentication_call_get_captcha_data

1042

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1043

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

1044

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> in_ID</code>,

1045

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *in_Mime_Type</code>,

1046

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()">tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data</a> callback</code>,

1047

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1048

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

1049

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1050

1051

Start a GetCaptchaData method call.

1052

1053

1054

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Fetch and return the captcha data. In protocols where captchas are downloaded out-of-band (for instance via HTTP), the connection manager is expected to do so. Returns an empty array if the type was &quot;qa&quot; <tp:rationale> If audio-based and image-based captchas are both available, we don't want to waste time downloading the audio until/unless the user asks to hear it. The extra D-Bus round-trips are not a problem, since they are expected to be quick compared with the time taken for the user to solve the captcha. </tp:rationale>

1055

1056

1057

1058

1059

<col>

1060

</colgroup>

1061

<tbody>

1062

<tr>

1063

<td><code>proxy</code> :</td>

1064

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

1065

</td>

1066

</tr>

1067

<tr>

1068

<td><code>timeout_ms</code> :</td>

1069

<td>the timeout in milliseconds, or -1 to use the

1070

default</td>

1071

</tr>

1072

<tr>

1073

1074

<td>Used to pass an 'in' argument: The ID of the captcha of which to retrieve data.</td>

1075

</tr>

1076

<tr>

1077

1078

<td>Used to pass an 'in' argument: MIME type picked by the Handler, chosen from the list of MIME types received in <tp:member-ref>GetCaptchas</tp:member-ref>. <tp:rationale> XEP-0158 allows the same captcha to be made available in multiple formats, for instance the same spoken question as audio/x-wav, application/ogg and audio/speex. </tp:rationale></td>

1079

</tr>

1080

<tr>

1081

<td><code>callback</code> :</td>

1082

<td>called when the method call succeeds or fails;

1083

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1084

reply tracking</td>

1085

</tr>

1086

<tr>

1087

1088

<td>user-supplied data passed to the callback;

1089

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1090

</td>

1091

</tr>

1092

<tr>

1093

<td><code>destroy</code> :</td>

1094

<td>called with the user_data as argument, after the

1095

call has succeeded, failed or been cancelled;

1096

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1097

</td>

1098

</tr>

1099

<tr>

1100

<td><code>weak_object</code> :</td>

1101

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1102

weakly referenced; if it is destroyed, this call

1103

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1104

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1105

</td>

1106

</tr>

1107

<tr>

1108

<td>Returns :</td>

1109

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1110

progress. It is borrowed from the object, and will become

1111

invalid when the callback is called, the call is

1112

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

1113

</tr>

1114

</tbody>

1115

</table></div>

1116

</div>

1117

<hr>

1118

1119

<a name="tp-cli-channel-interface-captcha-authentication-call-get-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_call_get_captchas ()</h3>

1120

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_interface_captcha_authentication_call_get_captchas

1121

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1122

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_ms</code>,

1123

<code><a class="link" href="telepathy-glib-channel-auth.html#tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas" title="tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()">tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas</a> callback</code>,

1124

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1125

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>,

1126

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1127

1128

Start a GetCaptchas method call.

1129

1130

1131

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Gets information regarding each of the captcha methods available and which and how many need to be successfully answered To call this method successfully, the state must be Local_Pending or Try_Again. If it is Local_Pending, it remains Local_Pending. If called more than once while in Local_Pending state, or if the state is Try_Again, this method fetches a new set of captcha challenges, if possible, and the state returns to Local_Pending. <tp:rationale> For instance, you could call GetCaptchas again from Local_Pending state if the user indicates that they can't understand the initially-offered captcha. This is a method, not a property, so that it can be used to fetch more than one set of captcha challenges, and so that change notification is not required. Only the Handler should call this method and calling GetAll would not reduce round-trips, so the usual reasons to prefer a property do not apply here. </tp:rationale>

1132

1133

1134

1135

1136

<col>

1137

</colgroup>

1138

<tbody>

1139

<tr>

1140

<td><code>proxy</code> :</td>

1141

<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

1142

</td>

1143

</tr>

1144

<tr>

1145

<td><code>timeout_ms</code> :</td>

1146

<td>the timeout in milliseconds, or -1 to use the

1147

default</td>

1148

</tr>

1149

<tr>

1150

<td><code>callback</code> :</td>

1151

<td>called when the method call succeeds or fails;

1152

may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no

1153

reply tracking</td>

1154

</tr>

1155

<tr>

1156

1157

<td>user-supplied data passed to the callback;

1158

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1159

</td>

1160

</tr>

1161

<tr>

1162

<td><code>destroy</code> :</td>

1163

<td>called with the user_data as argument, after the

1164

call has succeeded, failed or been cancelled;

1165

must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1166

</td>

1167

</tr>

1168

<tr>

1169

<td><code>weak_object</code> :</td>

1170

<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> which will be

1171

weakly referenced; if it is destroyed, this call

1172

will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1173

<code>callback</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1174

</td>

1175

</tr>

1176

<tr>

1177

<td>Returns :</td>

1178

<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> representing the call in

1179

progress. It is borrowed from the object, and will become

1180

invalid when the callback is called, the call is

1181

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a> becomes invalid.</td>

1182

</tr>

1183

</tbody>

1184

</table></div>

1185

</div>

1186

<hr>

1187

1188

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-answer-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas ()</h3>

1189

<pre class="programlisting">void (*tp_cli_channel_interface_captcha_authentication_callback_for_answer_captchas)

1190

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1191

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1192

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1193

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1194

1195

Signature of the callback called when a AnswerCaptchas method call

1196

succeeds or fails.

1197

1198

1199

1200

1201

<col>

1202

</colgroup>

1203

<tbody>

1204

<tr>

1205

<td><code>proxy</code> :</td>

1206

<td>the proxy on which the call was made</td>

1207

</tr>

1208

<tr>

1209

<td><code>error</code> :</td>

1210

<td>

1211

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1212

</tr>

1213

<tr>

1214

1215

<td>user-supplied data</td>

1216

</tr>

1217

<tr>

1218

<td><code>weak_object</code> :</td>

1219

<td>user-supplied object</td>

1220

</tr>

1221

</tbody>

1222

</table></div>

1223

</div>

1224

<hr>

1225

1226

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-cancel-captcha"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha ()</h3>

1227

<pre class="programlisting">void (*tp_cli_channel_interface_captcha_authentication_callback_for_cancel_captcha)

1228

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1229

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1230

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1231

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1232

1233

Signature of the callback called when a CancelCaptcha method call

1234

succeeds or fails.

1235

1236

1237

1238

1239

<col>

1240

</colgroup>

1241

<tbody>

1242

<tr>

1243

<td><code>proxy</code> :</td>

1244

<td>the proxy on which the call was made</td>

1245

</tr>

1246

<tr>

1247

<td><code>error</code> :</td>

1248

<td>

1249

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1250

</tr>

1251

<tr>

1252

1253

<td>user-supplied data</td>

1254

</tr>

1255

<tr>

1256

<td><code>weak_object</code> :</td>

1257

<td>user-supplied object</td>

1258

</tr>

1259

</tbody>

1260

</table></div>

1261

</div>

1262

<hr>

1263

1264

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-get-captcha-data"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data ()</h3>

1265

<pre class="programlisting">void (*tp_cli_channel_interface_captcha_authentication_callback_for_get_captcha_data)

1266

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1267

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray">GArray</a> *out_Captcha_Data</code>,

1268

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1269

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1270

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1271

1272

Signature of the callback called when a GetCaptchaData method call

1273

succeeds or fails.

1274

1275

1276

1277

1278

<col>

1279

</colgroup>

1280

<tbody>

1281

<tr>

1282

<td><code>proxy</code> :</td>

1283

<td>the proxy on which the call was made</td>

1284

</tr>

1285

<tr>

1286

<td><code>out_Captcha_Data</code> :</td>

1287

<td>Used to return an 'out' argument if <code>error</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: Captcha data as requested.</td>

1288

</tr>

1289

<tr>

1290

<td><code>error</code> :</td>

1291

<td>

1292

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1293

</tr>

1294

<tr>

1295

1296

<td>user-supplied data</td>

1297

</tr>

1298

<tr>

1299

<td><code>weak_object</code> :</td>

1300

<td>user-supplied object</td>

1301

</tr>

1302

</tbody>

1303

</table></div>

1304

</div>

1305

<hr>

1306

1307

<a name="tp-cli-channel-interface-captcha-authentication-callback-for-get-captchas"></a><h3>tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas ()</h3>

1308

<pre class="programlisting">void (*tp_cli_channel_interface_captcha_authentication_callback_for_get_captchas)

1309

(<code><a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a> *proxy</code>,

1310

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *out_Captcha_Info</code>,

1311

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> out_Number_Required</code>,

1312

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *out_Language</code>,

1313

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error</code>,

1314

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1315

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> *weak_object</code>);</pre>

1316

1317

Signature of the callback called when a GetCaptchas method call

1318

succeeds or fails.

1319

1320

1321

1322

1323

<col>

1324

</colgroup>

1325

<tbody>

1326

<tr>

1327

<td><code>proxy</code> :</td>

1328

<td>the proxy on which the call was made</td>

1329

</tr>

1330

<tr>

1331

<td><code>out_Captcha_Info</code> :</td>

1332

<td>Used to return an 'out' argument if <code>error</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Information about each of the available captcha methods.</td>

1333

</tr>

1334

<tr>

1335

<td><code>out_Number_Required</code> :</td>

1336

<td>Used to return an 'out' argument if <code>error</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> The number of captcha methods required to be answered in order to successfully complete this captcha challenge (most frequently 1, but XMPP allows servers to demand that more than one captcha is answered).</td>

1337

</tr>

1338

<tr>

1339

<td><code>out_Language</code> :</td>

1340

<td>Used to return an 'out' argument if <code>error</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> The language of each Label in Captcha_Info if available, for instance en_US, or &quot;&quot; if unknown.</td>

1341

</tr>

1342

<tr>

1343

<td><code>error</code> :</td>

1344

<td>

1345

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>

1346

</tr>

1347

<tr>

1348

1349

<td>user-supplied data</td>

1350

</tr>

1351

<tr>

1352

<td><code>weak_object</code> :</td>

1353

<td>user-supplied object</td>

1354

</tr>

1355

</tbody>

1356

</table></div>

1357

</div>

1546

1358

</div>

1547

1359

</div>

1548

1360

1549

1361

<hr>

1550

Generated by GTK-Doc V1.20</div>

1362

Generated by GTK-Doc V1.19</div>

1551

1363

</body>

1552

1364

</html>

b'\\ No newline at end of file'