Symbian3/SDK/Source/GUID-C72CF928-F32E-55CF-A4B0-B51CD7D14F8A.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-C72CF928-F32E-55CF-A4B0-B51CD7D14F8A.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-C72CF928-F32E-55CF-A4B0-B51CD7D14F8A" xml:lang="en"><title>How
+to use file server sessions</title><shortdesc>This topic describes how to use file server sessions.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The <codeph>Rfs</codeph> class represents a session with the file server.
+The following code demonstrates the use of the <keyword>session         path</keyword> and
+shows how to connect and disconnect to and from the file server. </p>
+<ul>
+<li id="GUID-6D41700D-4355-5029-A767-4D26E830522D"><p>Use <codeph>Connect()</codeph> to
+connect to the file server. </p> </li>
+<li id="GUID-AD64EBC8-00EF-5AB9-9902-33CA63FBD41E"><p>Use <codeph>SessionPath()</codeph> to
+get the session path. </p> </li>
+<li id="GUID-E38A2DDB-0071-505F-9D6A-37A4BB22C4C5"><p>Use <codeph>SetSessionPath()</codeph> to
+set the session path. </p> </li>
+<li id="GUID-54C5D745-D2DE-5B3B-AA67-9A3B0505515B"><p>Use <codeph>Close()</codeph> to
+close the file server session when its use is complete. </p> </li>
+</ul>
+<codeblock id="GUID-AFD9152A-0439-5807-905D-1EA6FBC2BF8B" xml:space="preserve">_LIT(KSession,"Session path for fsSession is %S\n"); 
+RFs fsSession;
+CleanupClosePushL(fsSession);
+User::LeaveIfError(fsSession.Connect()); 
+TFileName path;
+User::LeaveIfError(fsSession.SessionPath(path));
+console-&gt;Printf(KSession,&amp;path); 
+... 
+... 
+fsSession.Close();
+CleanupStack::PopAndDestroy();</codeblock>
+<p>Use <xref href="GUID-16B0008A-0F85-3C1E-89E1-E7431E2C93B9.dita"><apiname>CleanupClosePushL()</apiname></xref> and <xref href="GUID-0DD554D7-B9B1-3FD3-898F-4D855144FCEA.dita#GUID-0DD554D7-B9B1-3FD3-898F-4D855144FCEA/GUID-C3BB6B4F-8096-3D74-9BEA-D77F309D900A"><apiname>CleanupStack::PopAndDestroy()</apiname></xref> so
+that <codeph>fsSession</codeph> is still closed if any of the <xref href="GUID-C197C9A7-EA05-3F24-9854-542E984C612D.dita#GUID-C197C9A7-EA05-3F24-9854-542E984C612D/GUID-96AFAC46-F3AD-392B-8A97-AFCBF2978CFB"><apiname>User::LeaveIfError()</apiname></xref> functions
+leave. </p>
+<p>See also <xref href="GUID-76D1438E-445E-5864-BA9D-27BC61D72C1B.dita">How to
+use CleanupClosePushL()</xref>. </p>
+<section id="GUID-9F204CC0-F4AE-4A84-805C-A10E07ECACF9"><title>Notes</title> <ul>
+<li id="GUID-FB2F41D7-445D-52B1-85DA-AF48CD4E7AA7"><p>The session path is
+the path in which, by default, all operations in the current file server session
+take place. The path can be changed by a call to <codeph>RFs::SetSessionPath()</codeph>. </p> </li>
+<li id="GUID-DEA3DC5E-3315-5091-B69A-396A93588791"><p>Unlike some other systems,
+there is a <i>single</i> path, rather than a path for each drive: the path
+consists of a drive and a path specification. </p> </li>
+<li id="GUID-9FE6A9C7-08C8-57D4-8E5F-FA3FE7894544"><p>You can make several
+connections to the file server from the same program, and each can have a
+different session path. </p> </li>
+<li id="GUID-349AE117-FB3F-5147-B62D-9A74AA0326EC"><p>If a file server session
+is not closed using the <codeph>Close()</codeph> function, it is closed automatically
+when the thread that opened it terminates. However, when operations using
+the file server session have finished, it is good practice to close all resources
+immediately. </p> </li>
+</ul> </section>
+</conbody></concept>
\ No newline at end of file