FAQ-0800 How can I detect the default document folder on a device?


FAQ-0800 How can I detect the default document folder on a device?

» Symbian OS » Developer Knowledgebase » FAQ-0800

Classification:	C++	Category:	EIKON
Created:	06/11/2002	Modified:	07/23/2003
Number:	FAQ-0800
Platform:	ER5, Symbian OS v6.0

Question:
I'd like to find out the default document folder on the device, how can I do this?

Answer:
This is generally possible - but not via any set of supported or documented APIs. This means it cannot be guaranteed to work and may change between different devices and/or different Symbian OS releases. However, the following code has been used successfully:

Nokia 9200 Communicator Series

// Constant for obtaining default document folder
const TUid KUidGlobalDefaultDocumentDirectory = {0x10005127};
//
#include // for CDictionaryFileStore
...

{

TFileName defaultFolder;

CDictionaryStore* store=CDictionaryFileStore::SystemLC(iEikonEnv->FsSession());

if (store->IsPresentL(KUidGlobalDefaultDocumentDirectory))

{

RDictionaryReadStream stream;

stream.OpenLC(*store,KUidGlobalDefaultDocumentDirectory);

stream >> defaultFolder;

CleanupStack::PopAndDestroy(); //stream

}

else

defaultFolder.Zero();

CleanupStack::PopAndDestroy(); //store

}

Symbian OS v5 (and earlier)

_LIT(KShellIniFile,"c:\\System\\Apps\\Shell\\Shell.ini");
const TUid KUidShellApp = {0x10000076};

const TUid KUidShellPreferences = {0x10000296}; // Old, not used in ER5
const TUid KUidShlPreferencesER5 = {0x10003EE0}; // New, for ER5

...

{

CDictionaryStore* shellIni=CDictionaryFileStore::OpenLC(iEikonEnv->FsSession(),KShellIniFile,KUidShellApp);

RDictionaryReadStream stream;

stream.OpenLC(*shellIni,KUidShellPreferences);

TInt32 statusFlags;

TFileName aDefaultDir;

TRAPD(err,stream >> statusFlags);

if (err==KErrEof)

{

// KUidShellPreferences not found

CleanupStack::PopAndDestroy(); //stream

stream.OpenLC(*shellIni, KUidShlPreferencesER5);

TRAP(err,stream >> statusFlags);

if (err==KErrEof)

// KUidShellPreferencesER5 not found either

User::Leave(KErrNotSupported);

else

User::Leave(err);

}

else

User::Leave(err);

stream >> aDefaultDir;

CleanupStack::PopAndDestroy(); // stream

CleanupStack::PopAndDestroy(); // shellIni

}