~ubuntu-branches/ubuntu/quantal/lasso/quantal

« back to all changes in this revision

Viewing changes to docs/reference/lasso/html/lasso-LassoIdWsf2Profile.html

  • Committer: Package Import Robot
  • Author(s): Frederic Peters
  • Date: 2012-04-02 17:31:31 UTC
  • mfrom: (1.1.10) (7.1.10 sid)
  • Revision ID: package-import@ubuntu.com-20120402173131-b31061tenxff75tf
Tags: 2.3.6-2
Fix building against glib 2.32 (closes: #665565, #666636)

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>LassoIdWsf2Profile</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="Lasso Reference Manual">
8
8
<link rel="up" href="idwsf2.html" title="ID-WSF 2.0">
9
9
<link rel="prev" href="lasso-LassoIdWsf2DataService.html" title="LassoIdWsf2DataService">
10
 
<link rel="next" href="lasso-Addon-to-SAML-20-profile-for-ID-WSF-20-bootsraping.html" title="Addon to SAML 2.0 profile for ID-WSF 2.0 bootsraping">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
10
<link rel="next" href="lasso-Addon-to-SAML-2.0-profile-for-ID-WSF-2.0-bootsraping.html" title="Addon to SAML 2.0 profile for ID-WSF 2.0 bootsraping">
 
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="chapter" href="lasso.html" title="Lasso &amp; Liberty Alliance Overview">
14
 
<link rel="reference" href="rn01.html" title="Application Programming Interface">
15
 
<link rel="chapter" href="architecture.html" title="Lasso Architecture">
16
 
<link rel="chapter" href="idff.html" title="Identity Federation Framework - ID-FF 1.2 profiles">
17
 
<link rel="chapter" href="xml-idff.html" title="Objects from ID-FF 1.2 schemas">
18
 
<link rel="chapter" href="saml2.html" title="SAML 2.0 Single Sign On profiles">
19
 
<link rel="chapter" href="xml-samlv2.html" title="Objects from SAML 2.0 schemas">
20
 
<link rel="chapter" href="idwsf.html" title="Identity Web Services Framework 1.0">
21
 
<link rel="chapter" href="xml-idwsf.html" title="Objects from ID-WSF 1.0 schemas">
22
 
<link rel="chapter" href="idwsf2.html" title="ID-WSF 2.0">
23
 
<link rel="chapter" href="xml-idwsf2.html" title="Objects from ID-WSF 2.0 schemas">
24
 
<link rel="chapter" href="soap.html" title="Object from the SOAP 1.1 schemas">
25
 
<link rel="chapter" href="xml-dsig.html" title="Object from the XML-DSIG schemas">
26
 
<link rel="chapter" href="ws-addr.html" title="Object from the WS-* schemas">
27
 
<link rel="part" href="pt01.html" title="Part II. Appendix">
28
 
<link rel="index" href="api-index.html" title="API Index">
29
 
<link rel="glossary" href="annotation-glossary.html" title="Annotation Glossary">
30
13
</head>
31
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
32
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
35
18
<td><a accesskey="u" href="idwsf2.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
36
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
37
20
<th width="100%" align="center">Lasso Reference Manual</th>
38
 
<td><a accesskey="n" href="lasso-Addon-to-SAML-20-profile-for-ID-WSF-20-bootsraping.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
21
<td><a accesskey="n" href="lasso-Addon-to-SAML-2.0-profile-for-ID-WSF-2.0-bootsraping.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
39
22
</tr>
40
23
<tr><td colspan="5" class="shortcuts">
41
24
<a href="#lasso-LassoIdWsf2Profile.synopsis" class="shortcut">Top</a>
42
 
                 | 
43
 
                <a href="#lasso-LassoIdWsf2Profile.description" class="shortcut">Description</a>
 
25
                   | 
 
26
                  <a href="#lasso-LassoIdWsf2Profile.description" class="shortcut">Description</a>
44
27
</td></tr>
45
28
</table>
46
 
<div class="refentry" title="LassoIdWsf2Profile">
 
29
<div class="refentry">
47
30
<a name="lasso-LassoIdWsf2Profile"></a><div class="titlepage"></div>
48
31
<div class="refnamediv"><table width="100%"><tr>
49
32
<td valign="top">
52
35
</td>
53
36
<td valign="top" align="right"></td>
54
37
</tr></table></div>
55
 
<div class="refsynopsisdiv" title="Synopsis">
 
38
<div class="refsynopsisdiv">
56
39
<a name="lasso-LassoIdWsf2Profile.synopsis"></a><h2>Synopsis</h2>
57
 
<pre class="synopsis">
58
 
                    LassoIdWsf2Profile;
59
 
void                lasso_idwsf2_profile_set_epr        (LassoIdWsf2Profile *idwsf2_profile,
60
 
                                                         LassoWsAddrEndpointReference *epr);
61
 
LassoWsAddrEndpointReference* lasso_idwsf2_profile_get_epr
62
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);
63
 
LassoSoapEnvelope*  lasso_idwsf2_profile_get_soap_envelope_request
64
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);
65
 
LassoSoapEnvelope*  lasso_idwsf2_profile_get_soap_envelope_response
66
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);
67
 
lasso_error_t       lasso_idwsf2_profile_init_request   (LassoIdWsf2Profile *profile);
68
 
lasso_error_t       lasso_idwsf2_profile_build_request_msg
69
 
                                                        (LassoIdWsf2Profile *profile,
70
 
                                                         const char *security_mech_id);
71
 
lasso_error_t       lasso_idwsf2_profile_process_request_msg
72
 
                                                        (LassoIdWsf2Profile *profile,
73
 
                                                         const char *msg);
74
 
lasso_error_t       lasso_idwsf2_profile_check_security_mechanism
75
 
                                                        (LassoIdWsf2Profile *profile,
76
 
                                                         const char *security_mech_id);
77
 
LassoNode *         lasso_idwsf2_profile_get_name_identifier
78
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);
79
 
lasso_error_t       lasso_idwsf2_profile_init_response  (LassoIdWsf2Profile *profile);
80
 
lasso_error_t       lasso_idwsf2_profile_init_soap_fault_response
81
 
                                                        (LassoIdWsf2Profile *profile,
82
 
                                                         const char *faultcode,
83
 
                                                         const char *faultstring,
84
 
                                                         <a
85
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
86
 
>GList</a> *details);
87
 
lasso_error_t       lasso_idwsf2_profile_redirect_user_for_interaction
88
 
                                                        (LassoIdWsf2Profile *profile,
89
 
                                                         const <a
90
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
91
 
>gchar</a> *redirect_url,
92
 
                                                         <a
93
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
94
 
>gboolean</a> for_data);
95
 
lasso_error_t       lasso_idwsf2_profile_build_response_msg
96
 
                                                        (LassoIdWsf2Profile *profile);
97
 
lasso_error_t       lasso_idwsf2_profile_process_response_msg
98
 
                                                        (LassoIdWsf2Profile *profile,
99
 
                                                         const char *msg);
 
40
<pre class="synopsis">struct              <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile">LassoIdWsf2Profile</a>;
 
41
<span class="returnvalue">void</span>                <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-set-epr" title="lasso_idwsf2_profile_set_epr ()">lasso_idwsf2_profile_set_epr</a>        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>,
 
42
                                                         <em class="parameter"><code><a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="type">LassoWsAddrEndpointReference</span></a> *epr</code></em>);
 
43
<a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="returnvalue">LassoWsAddrEndpointReference</span></a> *  <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-epr" title="lasso_idwsf2_profile_get_epr ()">lasso_idwsf2_profile_get_epr</a>
 
44
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
 
45
<a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> *  <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-soap-envelope-request" title="lasso_idwsf2_profile_get_soap_envelope_request ()">lasso_idwsf2_profile_get_soap_envelope_request</a>
 
46
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
 
47
<a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> *  <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-soap-envelope-response" title="lasso_idwsf2_profile_get_soap_envelope_response ()">lasso_idwsf2_profile_get_soap_envelope_response</a>
 
48
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
 
49
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-init-request" title="lasso_idwsf2_profile_init_request ()">lasso_idwsf2_profile_init_request</a>   (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);
 
50
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-build-request-msg" title="lasso_idwsf2_profile_build_request_msg ()">lasso_idwsf2_profile_build_request_msg</a>
 
51
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
52
                                                         <em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);
 
53
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-process-request-msg" title="lasso_idwsf2_profile_process_request_msg ()">lasso_idwsf2_profile_process_request_msg</a>
 
54
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
55
                                                         <em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);
 
56
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-check-security-mechanism" title="lasso_idwsf2_profile_check_security_mechanism ()">lasso_idwsf2_profile_check_security_mechanism</a>
 
57
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
58
                                                         <em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);
 
59
<a class="link" href="lasso-node.html#LassoNode" title="struct LassoNode"><span class="returnvalue">LassoNode</span></a> *         <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-get-name-identifier" title="lasso_idwsf2_profile_get_name_identifier ()">lasso_idwsf2_profile_get_name_identifier</a>
 
60
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);
 
61
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-init-response" title="lasso_idwsf2_profile_init_response ()">lasso_idwsf2_profile_init_response</a>  (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);
 
62
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-init-soap-fault-response" title="lasso_idwsf2_profile_init_soap_fault_response ()">lasso_idwsf2_profile_init_soap_fault_response</a>
 
63
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
64
                                                         <em class="parameter"><code>const <span class="type">char</span> *faultcode</code></em>,
 
65
                                                         <em class="parameter"><code>const <span class="type">char</span> *faultstring</code></em>,
 
66
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *details</code></em>);
 
67
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-redirect-user-for-interaction" title="lasso_idwsf2_profile_redirect_user_for_interaction ()">lasso_idwsf2_profile_redirect_user_for_interaction</a>
 
68
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
69
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *redirect_url</code></em>,
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> for_data</code></em>);
 
71
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-build-response-msg" title="lasso_idwsf2_profile_build_response_msg ()">lasso_idwsf2_profile_build_response_msg</a>
 
72
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);
 
73
<span class="returnvalue">lasso_error_t</span>       <a class="link" href="lasso-LassoIdWsf2Profile.html#lasso-idwsf2-profile-process-response-msg" title="lasso_idwsf2_profile_process_response_msg ()">lasso_idwsf2_profile_process_response_msg</a>
 
74
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
75
                                                         <em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);
100
76
</pre>
101
77
</div>
102
 
<div class="refsect1" title="Description">
 
78
<div class="refsect1">
103
79
<a name="lasso-LassoIdWsf2Profile.description"></a><h2>Description</h2>
104
80
</div>
105
 
<div class="refsect1" title="Details">
 
81
<div class="refsect1">
106
82
<a name="lasso-LassoIdWsf2Profile.details"></a><h2>Details</h2>
107
 
<div class="refsect2" title="LassoIdWsf2Profile">
108
 
<a name="LassoIdWsf2Profile"></a><h3>LassoIdWsf2Profile</h3>
109
 
<pre class="programlisting">typedef struct {
 
83
<div class="refsect2">
 
84
<a name="LassoIdWsf2Profile"></a><h3>struct LassoIdWsf2Profile</h3>
 
85
<pre class="programlisting">struct LassoIdWsf2Profile {
110
86
        LassoProfile parent;
111
 
} LassoIdWsf2Profile;
 
87
};
112
88
</pre>
113
89
</div>
114
90
<hr>
115
 
<div class="refsect2" title="lasso_idwsf2_profile_set_epr ()">
 
91
<div class="refsect2">
116
92
<a name="lasso-idwsf2-profile-set-epr"></a><h3>lasso_idwsf2_profile_set_epr ()</h3>
117
 
<pre class="programlisting">void                lasso_idwsf2_profile_set_epr        (LassoIdWsf2Profile *idwsf2_profile,
118
 
                                                         LassoWsAddrEndpointReference *epr);</pre>
 
93
<pre class="programlisting"><span class="returnvalue">void</span>                lasso_idwsf2_profile_set_epr        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>,
 
94
                                                         <em class="parameter"><code><a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="type">LassoWsAddrEndpointReference</span></a> *epr</code></em>);</pre>
119
95
</div>
120
96
<hr>
121
 
<div class="refsect2" title="lasso_idwsf2_profile_get_epr ()">
 
97
<div class="refsect2">
122
98
<a name="lasso-idwsf2-profile-get-epr"></a><h3>lasso_idwsf2_profile_get_epr ()</h3>
123
 
<pre class="programlisting">LassoWsAddrEndpointReference* lasso_idwsf2_profile_get_epr
124
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);</pre>
 
99
<pre class="programlisting"><a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="returnvalue">LassoWsAddrEndpointReference</span></a> *  lasso_idwsf2_profile_get_epr
 
100
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
125
101
<p>
126
 
Return the EPR used by this profile.</p>
 
102
Return the EPR used by this profile.
 
103
</p>
127
104
<div class="variablelist"><table border="0">
128
105
<col align="left" valign="top">
129
106
<tbody>
130
107
<tr>
131
108
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
132
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
 
109
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
 
110
</tr>
 
111
<tr>
 
112
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
113
<td>a <a class="link" href="lasso-LassoWsAddrEndpointReference.html#LassoWsAddrEndpointReference" title="struct LassoWsAddrEndpointReference"><span class="type">LassoWsAddrEndpointReference</span></a> object, or NULL if none is set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
133
114
</td>
134
115
</tr>
135
 
<tr>
136
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
137
 
<td> a <span class="type">LassoWsAddrEndpointReference</span> object, or NULL if none is set.. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> none. </td>
138
 
</tr>
139
116
</tbody>
140
117
</table></div>
141
118
</div>
142
119
<hr>
143
 
<div class="refsect2" title="lasso_idwsf2_profile_get_soap_envelope_request ()">
 
120
<div class="refsect2">
144
121
<a name="lasso-idwsf2-profile-get-soap-envelope-request"></a><h3>lasso_idwsf2_profile_get_soap_envelope_request ()</h3>
145
 
<pre class="programlisting">LassoSoapEnvelope*  lasso_idwsf2_profile_get_soap_envelope_request
146
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);</pre>
 
122
<pre class="programlisting"><a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> *  lasso_idwsf2_profile_get_soap_envelope_request
 
123
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
147
124
<p>
148
 
Return the last parsed SOAP request object.</p>
 
125
Return the last parsed SOAP request object.
 
126
</p>
149
127
<div class="variablelist"><table border="0">
150
128
<col align="left" valign="top">
151
129
<tbody>
152
130
<tr>
153
131
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
154
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
 
132
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
 
133
</tr>
 
134
<tr>
 
135
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
136
<td>a <a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="type">LassoSoapEnvelope</span></a> object or NULL if no request as ever been
 
137
parsed with this object. You must free this object. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
155
138
</td>
156
139
</tr>
157
 
<tr>
158
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159
 
<td>transfer none. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> none. </td>
160
 
</tr>
161
140
</tbody>
162
141
</table></div>
163
142
</div>
164
143
<hr>
165
 
<div class="refsect2" title="lasso_idwsf2_profile_get_soap_envelope_response ()">
 
144
<div class="refsect2">
166
145
<a name="lasso-idwsf2-profile-get-soap-envelope-response"></a><h3>lasso_idwsf2_profile_get_soap_envelope_response ()</h3>
167
 
<pre class="programlisting">LassoSoapEnvelope*  lasso_idwsf2_profile_get_soap_envelope_response
168
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);</pre>
 
146
<pre class="programlisting"><a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="returnvalue">LassoSoapEnvelope</span></a> *  lasso_idwsf2_profile_get_soap_envelope_response
 
147
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
169
148
<p>
170
 
Return the last parsed SOAP response object.</p>
 
149
Return the last parsed SOAP response object.
 
150
</p>
171
151
<div class="variablelist"><table border="0">
172
152
<col align="left" valign="top">
173
153
<tbody>
174
154
<tr>
175
155
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
176
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
 
156
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
 
157
</tr>
 
158
<tr>
 
159
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
160
<td>a <a class="link" href="lasso-LassoSoapEnvelope.html#LassoSoapEnvelope" title="struct LassoSoapEnvelope"><span class="type">LassoSoapEnvelope</span></a> object or NULL if no response as ever been
 
161
parsed with this objects. You must free this object. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
177
162
</td>
178
163
</tr>
179
 
<tr>
180
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
181
 
<td>transfer none. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> none. </td>
182
 
</tr>
183
164
</tbody>
184
165
</table></div>
185
166
</div>
186
167
<hr>
187
 
<div class="refsect2" title="lasso_idwsf2_profile_init_request ()">
 
168
<div class="refsect2">
188
169
<a name="lasso-idwsf2-profile-init-request"></a><h3>lasso_idwsf2_profile_init_request ()</h3>
189
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_init_request   (LassoIdWsf2Profile *profile);</pre>
 
170
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_init_request   (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);</pre>
190
171
<p>
191
 
Initialize a new SOAP ID-WSF 2.0 request. Clear the existing request if one is currently set.</p>
 
172
Initialize a new SOAP ID-WSF 2.0 request. Clear the existing request if one is currently set.
 
173
</p>
192
174
<div class="variablelist"><table border="0">
193
175
<col align="left" valign="top">
194
176
<tbody>
195
177
<tr>
196
178
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
197
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
198
 
</td>
 
179
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
199
180
</tr>
200
181
<tr>
201
182
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
202
 
<td> 0 if successful, an error code otherwise.
203
 
</td>
 
183
<td>0 if successful, an error code otherwise.</td>
204
184
</tr>
205
185
</tbody>
206
186
</table></div>
207
187
</div>
208
188
<hr>
209
 
<div class="refsect2" title="lasso_idwsf2_profile_build_request_msg ()">
 
189
<div class="refsect2">
210
190
<a name="lasso-idwsf2-profile-build-request-msg"></a><h3>lasso_idwsf2_profile_build_request_msg ()</h3>
211
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_build_request_msg
212
 
                                                        (LassoIdWsf2Profile *profile,
213
 
                                                         const char *security_mech_id);</pre>
 
191
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_build_request_msg
 
192
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
193
                                                         <em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);</pre>
214
194
<p>
215
195
Serialize and sign, if needed, the SOAP request message, put the result in
216
196
</p>
218
198
<p>.
219
199
</p>
220
200
<p>
221
 
FIXME: really do sign messages.</p>
 
201
FIXME: really do sign messages.
 
202
</p>
222
203
<div class="variablelist"><table border="0">
223
204
<col align="left" valign="top">
224
205
<tbody>
225
206
<tr>
226
207
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
227
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
228
 
</td>
 
208
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
229
209
</tr>
230
210
<tr>
231
211
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
232
 
<td> 0 if successful, LASSO_PROFILE_ERROR_BUILDING_REQUEST_FAILED.
233
 
</td>
 
212
<td>0 if successful, LASSO_PROFILE_ERROR_BUILDING_REQUEST_FAILED.</td>
234
213
</tr>
235
214
</tbody>
236
215
</table></div>
237
216
</div>
238
217
<hr>
239
 
<div class="refsect2" title="lasso_idwsf2_profile_process_request_msg ()">
 
218
<div class="refsect2">
240
219
<a name="lasso-idwsf2-profile-process-request-msg"></a><h3>lasso_idwsf2_profile_process_request_msg ()</h3>
241
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_process_request_msg
242
 
                                                        (LassoIdWsf2Profile *profile,
243
 
                                                         const char *msg);</pre>
 
220
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_process_request_msg
 
221
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
222
                                                         <em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);</pre>
244
223
<p>
245
 
Parse a SOAP request message and initialize the SOAP Envelope for the response.</p>
 
224
Parse a SOAP request message and initialize the SOAP Envelope for the response.
 
225
</p>
246
226
<div class="variablelist"><table border="0">
247
227
<col align="left" valign="top">
248
228
<tbody>
249
229
<tr>
250
230
<td><p><span class="term"><em class="parameter"><code>wsf2_profile</code></em> :</span></p></td>
251
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
252
 
</td>
 
231
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
253
232
</tr>
254
233
<tr>
255
234
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
256
 
<td> a received SOAP message
257
 
</td>
 
235
<td>a received SOAP message</td>
258
236
</tr>
259
237
<tr>
260
238
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
261
 
<td> 0 if successful, an error code otherwise among:
 
239
<td>0 if successful, an error code otherwise among:
262
240
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
263
 
<li class="listitem"><p>LASSO_PARAM_ERROR_BAD_TYPE_OR_NULL_OBJ if <em class="parameter"><code>profile</code></em> is not a <span class="type">LassoIdWsf2Profile</span>
 
241
<li class="listitem"><p>LASSO_PARAM_ERROR_BAD_TYPE_OR_NULL_OBJ if <em class="parameter"><code>profile</code></em> is not a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a>
264
242
object,</p></li>
265
243
<li class="listitem"><p>LASSO_PARAM_ERROR_INVALID_VALUE if message is NULL,</p></li>
266
244
<li class="listitem"><p>LASSO_PROFILE_ERROR_INVALID_MSG if we cannot parse the message,</p></li>
273
251
</table></div>
274
252
</div>
275
253
<hr>
276
 
<div class="refsect2" title="lasso_idwsf2_profile_check_security_mechanism ()">
 
254
<div class="refsect2">
277
255
<a name="lasso-idwsf2-profile-check-security-mechanism"></a><h3>lasso_idwsf2_profile_check_security_mechanism ()</h3>
278
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_check_security_mechanism
279
 
                                                        (LassoIdWsf2Profile *profile,
280
 
                                                         const char *security_mech_id);</pre>
 
256
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_check_security_mechanism
 
257
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
258
                                                         <em class="parameter"><code>const <span class="type">char</span> *security_mech_id</code></em>);</pre>
281
259
<p>
282
260
Check ID-WSF 2.0 Security Mechanism upon the received request. It is mandatory that a
283
 
<span class="type">LassoServer</span> is setted for the <em class="parameter"><code>profile</code></em> object.</p>
 
261
<a class="link" href="lasso-LassoServer.html#LassoServer" title="struct LassoServer"><span class="type">LassoServer</span></a> is setted for the <em class="parameter"><code>profile</code></em> object.
 
262
</p>
284
263
<div class="variablelist"><table border="0">
285
264
<col align="left" valign="top">
286
265
<tbody>
287
266
<tr>
288
267
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
289
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
290
 
</td>
 
268
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
291
269
</tr>
292
270
<tr>
293
271
<td><p><span class="term"><em class="parameter"><code>security_mech_id:(allow-none)</code></em> :</span></p></td>
294
 
<td> the security mechanism to enforce, if none is provided Bearer is
295
 
assumed.
296
 
</td>
 
272
<td>the security mechanism to enforce, if none is provided Bearer is
 
273
assumed.</td>
297
274
</tr>
298
275
<tr>
299
276
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
300
 
<td> 0 if the request passed the check, an error code otherwise.
301
 
</td>
 
277
<td>0 if the request passed the check, an error code otherwise.</td>
302
278
</tr>
303
279
</tbody>
304
280
</table></div>
305
281
</div>
306
282
<hr>
307
 
<div class="refsect2" title="lasso_idwsf2_profile_get_name_identifier ()">
 
283
<div class="refsect2">
308
284
<a name="lasso-idwsf2-profile-get-name-identifier"></a><h3>lasso_idwsf2_profile_get_name_identifier ()</h3>
309
 
<pre class="programlisting">LassoNode *         lasso_idwsf2_profile_get_name_identifier
310
 
                                                        (LassoIdWsf2Profile *idwsf2_profile);</pre>
 
285
<pre class="programlisting"><a class="link" href="lasso-node.html#LassoNode" title="struct LassoNode"><span class="returnvalue">LassoNode</span></a> *         lasso_idwsf2_profile_get_name_identifier
 
286
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *idwsf2_profile</code></em>);</pre>
311
287
<p>
312
288
Return the NameIdentifier found in a WS-Security authentication token, when Bearer or SAML
313
289
security mechanism is used. This method does not validate any security conditions on the
314
 
assertion.</p>
 
290
assertion.
 
291
</p>
315
292
<div class="variablelist"><table border="0">
316
293
<col align="left" valign="top">
317
294
<tbody>
318
295
<tr>
319
296
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
320
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
 
297
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
 
298
</tr>
 
299
<tr>
 
300
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
301
<td>a <a class="link" href="lasso-node.html#LassoNode" title="struct LassoNode"><span class="type">LassoNode</span></a> object or NULL. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
321
302
</td>
322
303
</tr>
323
 
<tr>
324
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
325
 
<td> a <span class="type">LassoNode</span> object or NULL.. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=transfer"><span class="acronym">transfer</span></a> full. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=allow-none"><span class="acronym">allow-none</span></a> full. </td>
326
 
</tr>
327
304
</tbody>
328
305
</table></div>
329
306
</div>
330
307
<hr>
331
 
<div class="refsect2" title="lasso_idwsf2_profile_init_response ()">
 
308
<div class="refsect2">
332
309
<a name="lasso-idwsf2-profile-init-response"></a><h3>lasso_idwsf2_profile_init_response ()</h3>
333
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_init_response  (LassoIdWsf2Profile *profile);</pre>
 
310
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_init_response  (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);</pre>
334
311
<p>
335
 
Initialize a new SOAP ID-WSF 2.0 response. Clear the existing response if one is currently set.</p>
 
312
Initialize a new SOAP ID-WSF 2.0 response. Clear the existing response if one is currently set.
 
313
</p>
336
314
<div class="variablelist"><table border="0">
337
315
<col align="left" valign="top">
338
316
<tbody>
339
317
<tr>
340
318
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
341
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
342
 
</td>
 
319
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
343
320
</tr>
344
321
<tr>
345
322
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
346
 
<td> 0 if successful, an error code otherwise.
347
 
</td>
 
323
<td>0 if successful, an error code otherwise.</td>
348
324
</tr>
349
325
</tbody>
350
326
</table></div>
351
327
</div>
352
328
<hr>
353
 
<div class="refsect2" title="lasso_idwsf2_profile_init_soap_fault_response ()">
 
329
<div class="refsect2">
354
330
<a name="lasso-idwsf2-profile-init-soap-fault-response"></a><h3>lasso_idwsf2_profile_init_soap_fault_response ()</h3>
355
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_init_soap_fault_response
356
 
                                                        (LassoIdWsf2Profile *profile,
357
 
                                                         const char *faultcode,
358
 
                                                         const char *faultstring,
359
 
                                                         <a
360
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
361
 
>GList</a> *details);</pre>
 
331
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_init_soap_fault_response
 
332
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
333
                                                         <em class="parameter"><code>const <span class="type">char</span> *faultcode</code></em>,
 
334
                                                         <em class="parameter"><code>const <span class="type">char</span> *faultstring</code></em>,
 
335
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *details</code></em>);</pre>
362
336
<p>
363
 
Initialize a new SOAP 1.1 fault.</p>
 
337
Initialize a new SOAP 1.1 fault.
 
338
</p>
364
339
<div class="variablelist"><table border="0">
365
340
<col align="left" valign="top">
366
341
<tbody>
367
342
<tr>
368
343
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
369
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
370
 
</td>
 
344
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
371
345
</tr>
372
346
<tr>
373
347
<td><p><span class="term"><em class="parameter"><code>faultcode</code></em> :</span></p></td>
374
 
<td> a SOAP fault code, see <span class="type">LASSO_SOAP_FAULT_CLIENT</span>, <span class="type">LASSO_SOAP_FAULT_SERVER</span>.
375
 
</td>
 
348
<td>a SOAP fault code, see <span class="type">LASSO_SOAP_FAULT_CLIENT</span>, <span class="type">LASSO_SOAP_FAULT_SERVER</span>.</td>
376
349
</tr>
377
350
<tr>
378
351
<td><p><span class="term"><em class="parameter"><code>faultstring:(allow-none)</code></em> :</span></p></td>
379
 
<td> a human description of the error
380
 
</td>
 
352
<td>a human description of the error</td>
381
353
</tr>
382
354
<tr>
383
355
<td><p><span class="term"><em class="parameter"><code>details</code></em> :</span></p></td>
384
 
<td>allow-none)(element-type LassoNode. <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=allow-none"><span class="acronym">allow-none</span></a>. <acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> LassoNode. </td>
 
356
<td>complementary data describing the error, you can use
 
357
<a class="link" href="lasso-LassoIdWsf2UtilStatus.html#LassoIdWsf2UtilStatus" title="struct LassoIdWsf2UtilStatus"><span class="type">LassoIdWsf2UtilStatus</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> LassoNode]</span>
 
358
</td>
385
359
</tr>
386
360
<tr>
387
361
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
388
 
<td> 0 if successful, an error code otherwise.
389
 
</td>
 
362
<td>0 if successful, an error code otherwise.</td>
390
363
</tr>
391
364
</tbody>
392
365
</table></div>
393
366
</div>
394
367
<hr>
395
 
<div class="refsect2" title="lasso_idwsf2_profile_redirect_user_for_interaction ()">
 
368
<div class="refsect2">
396
369
<a name="lasso-idwsf2-profile-redirect-user-for-interaction"></a><h3>lasso_idwsf2_profile_redirect_user_for_interaction ()</h3>
397
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_redirect_user_for_interaction
398
 
                                                        (LassoIdWsf2Profile *profile,
399
 
                                                         const <a
400
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
401
 
>gchar</a> *redirect_url,
402
 
                                                         <a
403
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
404
 
>gboolean</a> for_data);</pre>
 
370
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_redirect_user_for_interaction
 
371
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
372
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *redirect_url</code></em>,
 
373
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> for_data</code></em>);</pre>
405
374
<p>
406
375
Create a SOAP fault containing a RedirectRequest element, with a redirectURL property set to
407
376
<em class="parameter"><code>redirect_url</code></em> concatenated with the parameter "transactionID" set to the messageID of the
408
 
response message.</p>
 
377
response message.
 
378
</p>
409
379
<div class="variablelist"><table border="0">
410
380
<col align="left" valign="top">
411
381
<tbody>
412
382
<tr>
413
383
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
414
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
415
 
</td>
 
384
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
416
385
</tr>
417
386
<tr>
418
387
<td><p><span class="term"><em class="parameter"><code>redirect_url</code></em> :</span></p></td>
419
 
<td> an URL where the user must be redirected
420
 
</td>
 
388
<td>an URL where the user must be redirected</td>
421
389
</tr>
422
390
<tr>
423
391
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
424
 
<td> 0 if successful, an error code otherwise.
425
 
</td>
 
392
<td>0 if successful, an error code otherwise.</td>
426
393
</tr>
427
394
</tbody>
428
395
</table></div>
429
396
</div>
430
397
<hr>
431
 
<div class="refsect2" title="lasso_idwsf2_profile_build_response_msg ()">
 
398
<div class="refsect2">
432
399
<a name="lasso-idwsf2-profile-build-response-msg"></a><h3>lasso_idwsf2_profile_build_response_msg ()</h3>
433
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_build_response_msg
434
 
                                                        (LassoIdWsf2Profile *profile);</pre>
 
400
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_build_response_msg
 
401
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>);</pre>
435
402
<p>
436
403
Serialize and sign the SOAP, if needed, the response message, put the result in
437
404
</p>
438
405
<pre class="programlisting">LASSO_PROFILE(profile)-&gt;msg_body</pre>
439
 
<p>.</p>
 
406
<p>.
 
407
</p>
440
408
<div class="variablelist"><table border="0">
441
409
<col align="left" valign="top">
442
410
<tbody>
443
411
<tr>
444
412
<td><p><span class="term"><em class="parameter"><code>idwsf2_profile</code></em> :</span></p></td>
445
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
446
 
</td>
 
413
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
447
414
</tr>
448
415
<tr>
449
416
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
450
 
<td> 0 if successful, LASSO_PROFILE_ERROR_BUILDING_RESPONSE_FAILED otherwise.
451
 
</td>
 
417
<td>0 if successful, LASSO_PROFILE_ERROR_BUILDING_RESPONSE_FAILED otherwise.</td>
452
418
</tr>
453
419
</tbody>
454
420
</table></div>
455
421
</div>
456
422
<hr>
457
 
<div class="refsect2" title="lasso_idwsf2_profile_process_response_msg ()">
 
423
<div class="refsect2">
458
424
<a name="lasso-idwsf2-profile-process-response-msg"></a><h3>lasso_idwsf2_profile_process_response_msg ()</h3>
459
 
<pre class="programlisting">lasso_error_t       lasso_idwsf2_profile_process_response_msg
460
 
                                                        (LassoIdWsf2Profile *profile,
461
 
                                                         const char *msg);</pre>
 
425
<pre class="programlisting"><span class="returnvalue">lasso_error_t</span>       lasso_idwsf2_profile_process_response_msg
 
426
                                                        (<em class="parameter"><code><a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> *profile</code></em>,
 
427
                                                         <em class="parameter"><code>const <span class="type">char</span> *msg</code></em>);</pre>
462
428
<p>
463
 
Parse a response received by SOAP. Place the parsed message in the <span class="type">LassoIdWsf2Profile</span> structure
464
 
in the <em class="parameter"><code>soap_envelope_response</code></em> field and the content of the body in the <em class="parameter"><code>response</code></em> field.</p>
 
429
Parse a response received by SOAP. Place the parsed message in the <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> structure
 
430
in the <em class="parameter"><code>soap_envelope_response</code></em> field and the content of the body in the <em class="parameter"><code>response</code></em> field.
 
431
</p>
465
432
<div class="variablelist"><table border="0">
466
433
<col align="left" valign="top">
467
434
<tbody>
468
435
<tr>
469
436
<td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
470
 
<td> a <span class="type">LassoIdWsf2Profile</span> object
471
 
</td>
 
437
<td>a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object</td>
472
438
</tr>
473
439
<tr>
474
440
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
475
 
<td> a string containing a response message
476
 
</td>
 
441
<td>a string containing a response message</td>
477
442
</tr>
478
443
<tr>
479
444
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
480
 
<td> 0 if successful, one of those error codes if the call fails: <div class="itemizedlist"><ul class="itemizedlist" type="disc">
 
445
<td>0 if successful, one of those error codes if the call fails: <div class="itemizedlist"><ul class="itemizedlist" type="disc">
481
446
<li class="listitem"><p>LASSO_PARAM_ERROR_BAD_TYPE_OR_NULL_OBJ if first parameter is not
482
 
a <span class="type">LassoIdWsf2Profile</span> object,</p></li>
 
447
a <a class="link" href="lasso-LassoIdWsf2Profile.html#LassoIdWsf2Profile" title="struct LassoIdWsf2Profile"><span class="type">LassoIdWsf2Profile</span></a> object,</p></li>
483
448
<li class="listitem"><p>LASSO_PARAM_ERROR_INVALID_VALUE if message is NULL,</p></li>
484
449
<li class="listitem"><p>LASSO_SOAP_ERROR_MISSING_BODY if no body element is found,</p></li>
485
450
<li class="listitem"><p>LASSO_PROFILE_ERROR_MISSING_RESPONSE if the body element is
494
459
</div>
495
460
<div class="footer">
496
461
<hr>
497
 
          Generated by GTK-Doc V1.11</div>
 
462
          Generated by GTK-Doc V1.17</div>
498
463
</body>
499
 
</html>
 
464
</html>
 
 
b'\\ No newline at end of file'