1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> |
2 <html xmlns="http://www.w3.org/1999/xhtml"> |
3 <title>TB10.1 Example Applications: RSecureSession Class Reference</title> |
3 <head> |
4 <link href="doxygen.css" rel="stylesheet" type="text/css"> |
4 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> |
5 <link href="tabs.css" rel="stylesheet" type="text/css"> |
5 <title>TB9.2 Example Applications: RSecureSession Class Reference</title> |
6 </head><body> |
6 <link href="tabs.css" rel="stylesheet" type="text/css"/> |
7 <!-- Generated by Doxygen 1.5.3 --> |
7 <link href="doxygen.css" rel="stylesheet" type="text/css"/> |
8 <h1>RSecureSession Class Reference</h1><!-- doxytag: class="RSecureSession" --> |
8 </head> |
9 <p> |
9 <body> |
10 <a href="class_r_secure_session-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0"> |
10 <!-- Generated by Doxygen 1.6.2 --> |
11 <tr><td></td></tr> |
11 <div class="contents"> |
12 <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr> |
12 <h1>RSecureSession Class Reference</h1><!-- doxytag: class="RSecureSession" --><!-- doxytag: inherits="RSessionBase" --> |
13 <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#691bf1b8993530995a26a65e6c77944e">RSecureSession</a> ()</td></tr> |
13 <p>Inherits RSessionBase.</p> |
14 |
14 |
15 <tr><td class="memItemLeft" nowrap align="right" valign="top">TInt </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#acec76ae20ca1a96380f33b82e85b271">Connect</a> ()</td></tr> |
15 <p><a href="class_r_secure_session-members.html">List of all members.</a></p> |
|
16 <table border="0" cellpadding="0" cellspacing="0"> |
|
17 <tr><td colspan="2"><h2>Public Member Functions</h2></td></tr> |
|
18 <tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#a691bf1b8993530995a26a65e6c77944e">RSecureSession</a> ()</td></tr> |
|
19 <tr><td class="memItemLeft" align="right" valign="top">TInt </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#aacec76ae20ca1a96380f33b82e85b271">Connect</a> ()</td></tr> |
|
20 <tr><td class="memItemLeft" align="right" valign="top">TVersion </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#a79c5e8c60338024c9858e8e9c081be06">Version</a> () const </td></tr> |
|
21 <tr><td class="memItemLeft" align="right" valign="top">TInt </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#a5ad87a05e485af49ed9b599d420c81ef">ResourceCountL</a> ()</td></tr> |
|
22 <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#a8c3903876a6e715f94bc6d4f762e3fa1">Close</a> ()</td></tr> |
|
23 </table> |
|
24 <hr/><a name="_details"></a><h2>Detailed Description</h2> |
|
25 <p>The client-side handle to a session with the server. The class forms a layer over the Symbian provided RSessionBase class. The main example code calls member functions in the subsession class to make requests to the server. The subsession forwards the requests to the server through the session. A request is identified by a number. This is one of the TSecureServerRequest enum values defined in <a class="el" href="secureclientandserver_8h.html">secureclientandserver.h</a>, The session passes the number and any arguments to the server in a TIpcArgs object. </p> |
|
26 <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="class_r_secure_sub_session.html">RSecureSubSession</a> </dd></dl> |
16 |
27 |
17 <tr><td class="memItemLeft" nowrap align="right" valign="top">TVersion </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#79c5e8c60338024c9858e8e9c081be06">Version</a> () const </td></tr> |
28 <p>Definition at line <a class="el" href="secureclient_8h_source.html#l00034">34</a> of file <a class="el" href="secureclient_8h_source.html">secureclient.h</a>.</p> |
18 |
29 <hr/><h2>Constructor & Destructor Documentation</h2> |
19 <tr><td class="memItemLeft" nowrap align="right" valign="top">TInt </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#5ad87a05e485af49ed9b599d420c81ef">ResourceCountL</a> ()</td></tr> |
30 <a class="anchor" id="a691bf1b8993530995a26a65e6c77944e"></a><!-- doxytag: member="RSecureSession::RSecureSession" ref="a691bf1b8993530995a26a65e6c77944e" args="()" --> |
20 |
|
21 <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_r_secure_session.html#8c3903876a6e715f94bc6d4f762e3fa1">Close</a> ()</td></tr> |
|
22 |
|
23 </table> |
|
24 <hr><a name="_details"></a><h2>Detailed Description</h2> |
|
25 The client-side handle to a session with the server. The class forms a layer over the Symbian provided RSessionBase class. The main example code calls member functions in the subsession class to make requests to the server. The subsession forwards the requests to the server through the session. A request is identified by a number. This is one of the TSecureServerRequest enum values defined in <a class="el" href="secureclientandserver_8h.html">secureclientandserver.h</a>, The session passes the number and any arguments to the server in a TIpcArgs object. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_r_secure_sub_session.html">RSecureSubSession</a> </dd></dl> |
|
26 |
|
27 <p>Definition at line <a class="el" href="secureclient_8h-source.html#l00034">34</a> of file <a class="el" href="secureclient_8h-source.html">secureclient.h</a>.</p> |
|
28 <hr><h2>Constructor & Destructor Documentation</h2> |
|
29 <a class="anchor" name="691bf1b8993530995a26a65e6c77944e"></a><!-- doxytag: member="RSecureSession::RSecureSession" ref="691bf1b8993530995a26a65e6c77944e" args="()" --> |
|
30 <div class="memitem"> |
31 <div class="memitem"> |
31 <div class="memproto"> |
32 <div class="memproto"> |
32 <table class="memname"> |
33 <table class="memname"> |
33 <tr> |
34 <tr> |
34 <td class="memname">RSecureSession::RSecureSession </td> |
35 <td class="memname">RSecureSession::RSecureSession </td> |
35 <td>(</td> |
36 <td>(</td> |
36 <td class="paramname"> </td> |
37 <td class="paramname"></td> |
37 <td> ) </td> |
38 <td> ) </td> |
38 <td width="100%"></td> |
39 <td></td> |
39 </tr> |
40 </tr> |
40 </table> |
41 </table> |
41 </div> |
42 </div> |
42 <div class="memdoc"> |
43 <div class="memdoc"> |
|
44 <p>Constructor. </p> |
43 |
45 |
44 <p> |
46 <p>Definition at line <a class="el" href="secureclientsession_8cpp_source.html#l00029">29</a> of file <a class="el" href="secureclientsession_8cpp_source.html">secureclientsession.cpp</a>.</p> |
45 Constructor. |
|
46 <p>Definition at line <a class="el" href="secureclientsession_8cpp-source.html#l00029">29</a> of file <a class="el" href="secureclientsession_8cpp-source.html">secureclientsession.cpp</a>.</p> |
|
47 |
47 |
48 </div> |
48 </div> |
49 </div><p> |
49 </div> |
50 <hr><h2>Member Function Documentation</h2> |
50 <hr/><h2>Member Function Documentation</h2> |
51 <a class="anchor" name="acec76ae20ca1a96380f33b82e85b271"></a><!-- doxytag: member="RSecureSession::Connect" ref="acec76ae20ca1a96380f33b82e85b271" args="()" --> |
51 <a class="anchor" id="aacec76ae20ca1a96380f33b82e85b271"></a><!-- doxytag: member="RSecureSession::Connect" ref="aacec76ae20ca1a96380f33b82e85b271" args="()" --> |
52 <div class="memitem"> |
52 <div class="memitem"> |
53 <div class="memproto"> |
53 <div class="memproto"> |
54 <table class="memname"> |
54 <table class="memname"> |
55 <tr> |
55 <tr> |
56 <td class="memname">TInt RSecureSession::Connect </td> |
56 <td class="memname">TInt RSecureSession::Connect </td> |
57 <td>(</td> |
57 <td>(</td> |
58 <td class="paramname"> </td> |
58 <td class="paramname"></td> |
59 <td> ) </td> |
59 <td> ) </td> |
60 <td width="100%"></td> |
60 <td></td> |
61 </tr> |
61 </tr> |
62 </table> |
62 </table> |
63 </div> |
63 </div> |
64 <div class="memdoc"> |
64 <div class="memdoc"> |
|
65 <p>Connects to the server using 4 message slots. This creates a new session with the server. In this example, the server is implemented as a separate thread. If the server is not running, the function starts the server before it tries to create a session with it. The version information defines the lowest version of the server with which this client is compatible. Version compatibility is checked when the server side session is created. In this example, the version of the server and the version requested by the client are the same. This is because they are defined by constants common to the client source code and the server source code. In a real application, versions would be defined independently. </p> |
|
66 <dl class="return"><dt><b>Returns:</b></dt><dd>KErrNone, if successful; otherwise, the value returned by <a class="el" href="secureclientandserver_8h.html#af110d475e98114c0f2a42b7313af8e67">StartThread()</a> or CreateSession() if they were unsuccessful. </dd></dl> |
|
67 <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="secureclientandserver_8h.html#af110d475e98114c0f2a42b7313af8e67">StartThread()</a> </dd> |
|
68 <dd> |
|
69 <a class="el" href="class_c_secure_server.html#a1f53e7eb732c048d41f7a74069c971bf">CSecureServer::NewSessionL()</a> </dd> |
|
70 <dd> |
|
71 <a class="el" href="class_r_secure_session.html#a79c5e8c60338024c9858e8e9c081be06">RSecureSession::Version()</a> </dd></dl> |
65 |
72 |
66 <p> |
73 <p>Definition at line <a class="el" href="secureclientsession_8cpp_source.html#l00044">44</a> of file <a class="el" href="secureclientsession_8cpp_source.html">secureclientsession.cpp</a>.</p> |
67 Connects to the server using 4 message slots. This creates a new session with the server. In this example, the server is implemented as a separate thread. If the server is not running, the function starts the server before it tries to create a session with it. The version information defines the lowest version of the server with which this client is compatible. Version compatibility is checked when the server side session is created. In this example, the version of the server and the version requested by the client are the same. This is because they are defined by constants common to the client source code and the server source code. In a real application, versions would be defined independently. <dl class="return" compact><dt><b>Returns:</b></dt><dd>KErrNone, if successful; otherwise, the value returned by <a class="el" href="secureclientandserver_8h.html#f110d475e98114c0f2a42b7313af8e67">StartThread()</a> or CreateSession() if they were unsuccessful. </dd></dl> |
|
68 <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="secureclientandserver_8h.html#f110d475e98114c0f2a42b7313af8e67">StartThread()</a> <p> |
|
69 <a class="el" href="class_c_secure_server.html#1f53e7eb732c048d41f7a74069c971bf">CSecureServer::NewSessionL()</a> <p> |
|
70 <a class="el" href="class_r_secure_session.html#79c5e8c60338024c9858e8e9c081be06">RSecureSession::Version()</a> </dd></dl> |
|
71 |
|
72 <p>Definition at line <a class="el" href="secureclientsession_8cpp-source.html#l00044">44</a> of file <a class="el" href="secureclientsession_8cpp-source.html">secureclientsession.cpp</a>.</p> |
|
73 |
74 |
74 </div> |
75 </div> |
75 </div><p> |
76 </div> |
76 <a class="anchor" name="79c5e8c60338024c9858e8e9c081be06"></a><!-- doxytag: member="RSecureSession::Version" ref="79c5e8c60338024c9858e8e9c081be06" args="() const " --> |
77 <a class="anchor" id="a79c5e8c60338024c9858e8e9c081be06"></a><!-- doxytag: member="RSecureSession::Version" ref="a79c5e8c60338024c9858e8e9c081be06" args="() const " --> |
77 <div class="memitem"> |
78 <div class="memitem"> |
78 <div class="memproto"> |
79 <div class="memproto"> |
79 <table class="memname"> |
80 <table class="memname"> |
80 <tr> |
81 <tr> |
81 <td class="memname">TVersion RSecureSession::Version </td> |
82 <td class="memname">TVersion RSecureSession::Version </td> |
82 <td>(</td> |
83 <td>(</td> |
83 <td class="paramtype">void </td> |
84 <td class="paramtype">void </td> |
84 <td class="paramname"> </td> |
85 <td class="paramname"></td> |
85 <td> ) </td> |
86 <td> ) </td> |
86 <td width="100%"> const</td> |
87 <td> const</td> |
87 </tr> |
88 </tr> |
88 </table> |
89 </table> |
89 </div> |
90 </div> |
90 <div class="memdoc"> |
91 <div class="memdoc"> |
|
92 <p>Gets the lowest version of the server with which this client is compatible. This is a client-side definition. If the server version is lower than this value, connection fails. In a real application, this is how a client can make sure that the server can provide the services that the client expects. The design of the client-server framework assumes that newer versions of a server are backward compatible with older versions of the server. </p> |
|
93 <dl class="return"><dt><b>Returns:</b></dt><dd>The version of the server that this client requires. </dd></dl> |
91 |
94 |
92 <p> |
95 <p>Definition at line <a class="el" href="secureclientsession_8cpp_source.html#l00059">59</a> of file <a class="el" href="secureclientsession_8cpp_source.html">secureclientsession.cpp</a>.</p> |
93 Gets the lowest version of the server with which this client is compatible. This is a client-side definition. If the server version is lower than this value, connection fails. In a real application, this is how a client can make sure that the server can provide the services that the client expects. The design of the client-server framework assumes that newer versions of a server are backward compatible with older versions of the server. <dl class="return" compact><dt><b>Returns:</b></dt><dd>The version of the server that this client requires. </dd></dl> |
|
94 |
|
95 <p>Definition at line <a class="el" href="secureclientsession_8cpp-source.html#l00059">59</a> of file <a class="el" href="secureclientsession_8cpp-source.html">secureclientsession.cpp</a>.</p> |
|
96 |
96 |
97 </div> |
97 </div> |
98 </div><p> |
98 </div> |
99 <a class="anchor" name="5ad87a05e485af49ed9b599d420c81ef"></a><!-- doxytag: member="RSecureSession::ResourceCountL" ref="5ad87a05e485af49ed9b599d420c81ef" args="()" --> |
99 <a class="anchor" id="a5ad87a05e485af49ed9b599d420c81ef"></a><!-- doxytag: member="RSecureSession::ResourceCountL" ref="a5ad87a05e485af49ed9b599d420c81ef" args="()" --> |
100 <div class="memitem"> |
100 <div class="memitem"> |
101 <div class="memproto"> |
101 <div class="memproto"> |
102 <table class="memname"> |
102 <table class="memname"> |
103 <tr> |
103 <tr> |
104 <td class="memname">TInt RSecureSession::ResourceCountL </td> |
104 <td class="memname">TInt RSecureSession::ResourceCountL </td> |
105 <td>(</td> |
105 <td>(</td> |
106 <td class="paramname"> </td> |
106 <td class="paramname"></td> |
107 <td> ) </td> |
107 <td> ) </td> |
108 <td width="100%"></td> |
108 <td></td> |
109 </tr> |
109 </tr> |
110 </table> |
110 </table> |
111 </div> |
111 </div> |
112 <div class="memdoc"> |
112 <div class="memdoc"> |
|
113 <p>Gets the resource count from the server. The resource count is the number of subsessions attached to the session. </p> |
|
114 <dl class="return"><dt><b>Returns:</b></dt><dd>The resource count. </dd></dl> |
113 |
115 |
114 <p> |
116 <p>Definition at line <a class="el" href="secureclientsession_8cpp_source.html#l00079">79</a> of file <a class="el" href="secureclientsession_8cpp_source.html">secureclientsession.cpp</a>.</p> |
115 Gets the resource count from the server. The resource count is the number of subsessions attached to the session. <dl class="return" compact><dt><b>Returns:</b></dt><dd>The resource count. </dd></dl> |
|
116 |
|
117 <p>Definition at line <a class="el" href="secureclientsession_8cpp-source.html#l00079">79</a> of file <a class="el" href="secureclientsession_8cpp-source.html">secureclientsession.cpp</a>.</p> |
|
118 |
117 |
119 </div> |
118 </div> |
120 </div><p> |
119 </div> |
121 <a class="anchor" name="8c3903876a6e715f94bc6d4f762e3fa1"></a><!-- doxytag: member="RSecureSession::Close" ref="8c3903876a6e715f94bc6d4f762e3fa1" args="()" --> |
120 <a class="anchor" id="a8c3903876a6e715f94bc6d4f762e3fa1"></a><!-- doxytag: member="RSecureSession::Close" ref="a8c3903876a6e715f94bc6d4f762e3fa1" args="()" --> |
122 <div class="memitem"> |
121 <div class="memitem"> |
123 <div class="memproto"> |
122 <div class="memproto"> |
124 <table class="memname"> |
123 <table class="memname"> |
125 <tr> |
124 <tr> |
126 <td class="memname">void RSecureSession::Close </td> |
125 <td class="memname">void RSecureSession::Close </td> |
127 <td>(</td> |
126 <td>(</td> |
128 <td class="paramname"> </td> |
127 <td class="paramname"></td> |
129 <td> ) </td> |
128 <td> ) </td> |
130 <td width="100%"></td> |
129 <td></td> |
131 </tr> |
130 </tr> |
132 </table> |
131 </table> |
133 </div> |
132 </div> |
134 <div class="memdoc"> |
133 <div class="memdoc"> |
|
134 <p>Deletes all handles associated with session. </p> |
135 |
135 |
136 <p> |
136 <p>Definition at line <a class="el" href="secureclientsession_8cpp_source.html#l00067">67</a> of file <a class="el" href="secureclientsession_8cpp_source.html">secureclientsession.cpp</a>.</p> |
137 Deletes all handles associated with session. |
|
138 <p>Definition at line <a class="el" href="secureclientsession_8cpp-source.html#l00067">67</a> of file <a class="el" href="secureclientsession_8cpp-source.html">secureclientsession.cpp</a>.</p> |
|
139 |
137 |
140 </div> |
138 </div> |
141 </div><p> |
139 </div> |
142 <hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 21 10:33:08 2010 for TB10.1 Example Applications by |
140 </div> |
|
141 <hr size="1"/><address style="text-align: right;"><small>Generated by |
143 <a href="http://www.doxygen.org/index.html"> |
142 <a href="http://www.doxygen.org/index.html"> |
144 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address> |
143 <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address> |
145 </body> |
144 </body> |
146 </html> |
145 </html> |