diff -r 48780e181b38 -r 578be2adaf3e Symbian3/PDK/Source/GUID-384A25D6-EC89-576E-857F-D8D26292FED9.dita --- a/Symbian3/PDK/Source/GUID-384A25D6-EC89-576E-857F-D8D26292FED9.dita Tue Jul 20 12:00:49 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-384A25D6-EC89-576E-857F-D8D26292FED9.dita Fri Aug 13 16:47:46 2010 +0100 @@ -1,104 +1,104 @@ - - - - - - Importing -KeysThis section describes how to import a key from a file using the -keystore. -

An externally generated key can be stored in the keystore using -the import functionality. Use the CUnifiedKeyStore::ImportKey() function -to import a key into the keystore.

The following steps explain the -process of importing keys:

 - - -Create a file system session using an RFs object. - - -Create an object of type CUnifiedKeyStore using CUnifiedKeyStore::NewL() or CUnifiedKeyStore::NewLC() function. - - -Initialize the member functions and keystore using the asynchronous -function CUnifiedKeyStore::Initialize(). - - -Open the file in read-only mode using the RFile object. - - -Import the key using CUnifiedKeyStore::ImportKey(). - - -

The required key is imported into the selected keystore.

-Example

The following code snippet shows how to -create a file system session object, initialize keystore and member functions, -and import a key.

-//Create a file system session object -RFs iFs; -CleanupClosePushL(&iFs); - - - -//Initialise the keystore and member functions -CUnifiedKeyStore* keyStore = CUnifiedKeyStore::NewL(iFs); -keyStore->Initialize(iStatus); //iStatus is a TRequestStatus object - - -... - - -HBufC8* keyData = NULL; -CleanupStack::PushL(keyData); - - - -// Specify the path of the file containing the key details -TDriveUnit sysDrive (RFs::GetSystemDrive()); -TFileName keyDataFile (sysDrive.Name()); -keyDataFile.Append(_LIT("<path where key is located; relative to the system drive in this case.>")); - - -//Specify the filename -TFileName buf; -buf.FillZ(); -buf.Copy(aDes); //Filename -keyDataFile.Append(buf); - - -//Open the file in read-only mode -RFile file; -User::LeaveIfError(file.Open(iFs, keyDataFile, EFileRead)); -CleanupClosePushL(file); - -TInt fileSize = 0; -User::LeaveIfError(file.Size(fileSize)); -HBufC8* iKeyData; - -if (fileSize > 0) - { - iKeyData = HBufC8::NewMaxLC(fileSize); - TPtr8 data(iKeyData->Des()); - data.FillZ(); - User::LeaveIfError(file.Read(data, fileSize)); - } - - - -//Import the key into the keystore -keyStore->ImportKey(0, iKeyData->Des(), usage, KLabel, accessType, - TTime(0), keyInfo, iStatus); - - -//Clean up -CleanupStack::Pop(keyData); -CleanupStack::PopAndDestroy(); // file -CleanupStack::PopAndDestroy(); // iFs - -Unified Keystore - + + + + + + Importing +KeysThis section describes how to import a key from a file using the +keystore. +

An externally generated key can be stored in the keystore using +the import functionality. Use the CUnifiedKeyStore::ImportKey() function +to import a key into the keystore.

The following steps explain the +process of importing keys:

 + + +Create a file system session using an RFs object. + + +Create an object of type CUnifiedKeyStore using CUnifiedKeyStore::NewL() or CUnifiedKeyStore::NewLC() function. + + +Initialize the member functions and keystore using the asynchronous +function CUnifiedKeyStore::Initialize(). + + +Open the file in read-only mode using the RFile object. + + +Import the key using CUnifiedKeyStore::ImportKey(). + + +

The required key is imported into the selected keystore.

+Example

The following code snippet shows how to +create a file system session object, initialize keystore and member functions, +and import a key.

+//Create a file system session object +RFs iFs; +CleanupClosePushL(&iFs); + + + +//Initialise the keystore and member functions +CUnifiedKeyStore* keyStore = CUnifiedKeyStore::NewL(iFs); +keyStore->Initialize(iStatus); //iStatus is a TRequestStatus object + + +... + + +HBufC8* keyData = NULL; +CleanupStack::PushL(keyData); + + + +// Specify the path of the file containing the key details +TDriveUnit sysDrive (RFs::GetSystemDrive()); +TFileName keyDataFile (sysDrive.Name()); +keyDataFile.Append(_LIT("<path where key is located; relative to the system drive in this case.>")); + + +//Specify the filename +TFileName buf; +buf.FillZ(); +buf.Copy(aDes); //Filename +keyDataFile.Append(buf); + + +//Open the file in read-only mode +RFile file; +User::LeaveIfError(file.Open(iFs, keyDataFile, EFileRead)); +CleanupClosePushL(file); + +TInt fileSize = 0; +User::LeaveIfError(file.Size(fileSize)); +HBufC8* iKeyData; + +if (fileSize > 0) + { + iKeyData = HBufC8::NewMaxLC(fileSize); + TPtr8 data(iKeyData->Des()); + data.FillZ(); + User::LeaveIfError(file.Read(data, fileSize)); + } + + + +//Import the key into the keystore +keyStore->ImportKey(0, iKeyData->Des(), usage, KLabel, accessType, + TTime(0), keyInfo, iStatus); + + +//Clean up +CleanupStack::Pop(keyData); +CleanupStack::PopAndDestroy(); // file +CleanupStack::PopAndDestroy(); // iFs + +Unified Keystore + \ No newline at end of file