Swi::RSisRegistryEntry Class Reference
class Swi::RSisRegistryEntry : public RSubSessionBase |
Client registry entry interface
Inherited Functions |
---|
| RSubSessionBase::CloseSubSession(TInt) |
| RSubSessionBase::CreateAutoCloseSubSession(RSessionBase &,TInt,const TIpcArgs &) |
| RSubSessionBase::CreateSubSession(const RSessionBase &,TInt) |
| RSubSessionBase::CreateSubSession(const RSessionBase &,TInt,const TIpcArgs &) |
| RSubSessionBase::RSubSessionBase() |
| RSubSessionBase::Send(TInt)const |
| RSubSessionBase::Send(TInt,const TIpcArgs &)const |
| RSubSessionBase::SendReceive(TInt)const |
| RSubSessionBase::SendReceive(TInt,TRequestStatus &)const |
| RSubSessionBase::SendReceive(TInt,const TIpcArgs &)const |
| RSubSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const |
| RSubSessionBase::Session()const |
| RSubSessionBase::SubSessionHandle()const |
Member Functions Documentation
AugmentationsL(RPointerArray< HBufC > &, RPointerArray< HBufC > &)
Returns all augmentations to this package. If no augmentations exist, the lists are empty
AugmentationsL(RPointerArray< CSisRegistryPackage > &)
Returns all augmentations to this package. If no augmentations exist, the list is empty
AugmentationsNumberL()
IMPORT_C TInt | AugmentationsNumberL | ( | ) | |
Gets the number of augmentations to this package.
CertificateChainsL(RPointerArray< HBufC8 > &)
Provides the certificate chains associated with this package
Close()
Closes the registry entry by closing the sub-session
ControllersL(RPointerArray< HBufC8 > &)
Return the controllers associated with this package as raw binary data
DependenciesL(RPointerArray< CSisRegistryDependency > &)
Returns the dependency array for this package (ie the packages, denoted by UID and the version ranges it depends on).
Note:
A is a "Dependent" of B if B is in A's dependency list A is a "dependency" of B if A is in B's dependency list For example consider a package Shared_library_B which is used by a package App_A. Shared_Library_B will be listed as a dependency in the sis file which installs App_A App_A cannot be installed successfully without Shared_Library_B being present. If Shared_Library_B is un-installed App_A may not function correctly. In this scenario App_A is a "dependent" of Shared_library_B Shared_library_B is a "dependency" of App_A
DependentPackagesL(RPointerArray< CSisRegistryPackage > &)
Returns the array of packages which are either dependent on this package or are augmentations of this package.
Note:
A is a "Dependent" of B if B is in A's dependency list A is a "dependency" of B if A is in B's dependency list For example consider a package Shared_library_B which is used by a package App_A. Shared_Library_B will be listed as a dependency in the sis file which installs App_A App_A cannot be installed successfully without Shared_Library_B being present. If Shared_Library_B is un-installed App_A may not function correctly. App_A is a "dependent" of Shared_library_B Shared_library_B is a "dependency" of App_A
Parameters
RPointerArray< CSisRegistryPackage > & aDependents | The array of packages which are either dependent on this package or are augmentations of this package (i.e. its dependents) |
EmbeddedPackagesL(RPointerArray< CSisRegistryPackage > &)
For a given package entry, return a array of packages that were embedded within this package.
EmbeddingPackagesL(RPointerArray< CSisRegistryPackage > &)
For a given package entry, return a array of packages that embed it. Note: This is possible when package A embeds D and the subsequently installed packages B and C each in turn embed D. As there will be a single copy and a single registration for D, it is imperative this back information is retained and it is accessible.
FilesL(RPointerArray< HBufC > &)
Provides a list of files installed by this package. This function may also return a file specification that contains wildcard characters ('?' and/or '*') if the package is a rom 'stub' sis file. Wildcard file specifications are NOT expanded and in this instance, the Count() member function on 'aFiles' cannot be used as an indicator of the number of files within the package.
HashL(const TDesC &)
Returns the hash value of a selected file, identified by its name
Parameters
const TDesC & aFileName | the full file path |
InstalledDrivesL()
IMPORT_C TUint | InstalledDrivesL | ( | ) | |
Returns set of drives to which files were installed in SIS file
IsAugmentationL()
IMPORT_C TBool | IsAugmentationL | ( | ) | |
Indicates whether or not the package augments another package
IsDeletablePreInstalledL()
IMPORT_C TBool | IsDeletablePreInstalledL | ( | ) | |
Returns whether or not the package was pre-installed and files should be deleted on uninstall. This will have been set true if and only if the swipolicy indicates that preinstalled files can be deleted, and the stub sis file used to install the package was writable at install time.
IsInRomL()
Indicates whether or not the package is installed on read-only media
IsPresentL()
IMPORT_C TBool | IsPresentL | ( | ) | |
Indicates whether the package is currently on the device (i.e. not on removable media that is not inserted).
IsSignedBySuCertL()
IMPORT_C TBool | IsSignedBySuCertL | ( | ) | |
Returns ETrue if the SIS package is signed by a certificate trusted by the device (SU) for eclipsing of files on the Z drive
IsSignedL()
IMPORT_C TBool | IsSignedL | ( | ) | |
Indicates whether the package is signed
LanguageL()
Gets the installed language for this package
LocalizedVendorNameL()
IMPORT_C HBufC * | LocalizedVendorNameL | ( | ) | |
Gets the localised vendor name of a package
Open(RSisRegistrySession &, TUid)
Opens the base package entry by specifying a UID.
Open(RSisRegistrySession &, const TDesC &, const TDesC &)
Open a registry entry (includes augmentations) by specifying a package and vendor name.
Parameters
RSisRegistrySession & aSession | The open RSisRegistrySession to use |
const TDesC & aPackageName | The name of the package |
const TDesC & aVendorName | The name of the vendor |
OpenL(RSisRegistrySession &, const CSisRegistryPackage &)
Open a registry entry (includes augmentations) by specifying a package
PackageL()
Returns the package of a current entry
PackageNameL()
IMPORT_C HBufC * | PackageNameL | ( | ) | |
Gets the name of a package
PreInstalledL()
IMPORT_C TBool | PreInstalledL | ( | ) | |
Returns whether or not the package was pre-installed
PropertyL(TInt)
Gets the value of a property within a package
Parameters
TInt aKey | The key to search for |
RegistryFilesL(RPointerArray< HBufC > &)
Returns the list of files that were created internally by registry. This function is to be used to determine the list of internal files that are not to be removed for an NR package during an RFS(Restore Factory Settings).
RemovableL()
IMPORT_C TBool | RemovableL | ( | ) | |
RemoveWithLastDependentL()
IMPORT_C TInt | RemoveWithLastDependentL | ( | ) | |
Indicates whether or not the package will be removed by uninstalling the last dependant
SelectedDriveL()
IMPORT_C TChar | SelectedDriveL | ( | ) | |
Returns what drive the user selected for files in the Sis file that did not specify drive.It returns KNoDriveSelected if user is not prompted for drive selection. For ROM stub packages it returns zero instead of KNoDriveSelected To determine the set of drives that files were installed to for this registry entry RSisRegistryEntry::InstalledDrivesL(). KNoDriveSelected
SendReceiveBufferLC(TInt)
HBufC8 * | SendReceiveBufferLC | ( | TInt | aMessage | ) | [protected] |
SendReceiveBufferLC(TInt, const TDesC &)
HBufC8 * | SendReceiveBufferLC | ( | TInt | aMessage, |
| const TDesC & | aInputDescriptor |
| ) | [protected] |
SetRemoveWithLastDependentL(TUid)
IMPORT_C void | SetRemoveWithLastDependentL | ( | TUid | uid | ) | |
This function is used to indicate the embedding package has been uninstalled but this package remained because of dependency.
ShutdownAllAppsL()
IMPORT_C TBool | ShutdownAllAppsL | ( | ) | |
Determines whether the base package or any of the partial upgrades require all applications within this package to be to be shutdown before uninstalling the package.
SidsL(RArray< TUid > &)
Returns an array of Sids (executables). The array is supplied by the client which is then populated.
Parameters
RArray< TUid > & aSids | On return, the array object to be populated. |
SizeL()
Returns the size of the installation excluding the size of other embedded packages
TrustL()
Indicates the level of trust associated with the package
Will be replaced in the future by a more complete TrustStatusL method.
TrustStatusL()
The trust status object for the entry. This supercedes information provided by the deprecated TrustL and TrustTimeStampL methods.
TrustTimeStampL()
IMPORT_C TTime | TrustTimeStampL | ( | ) | const |
The time at which the trust level was established
Will be replaced in the future by a more complete TrustStatusL method.
UidL()
Gets the UID of this package
UniqueVendorNameL()
IMPORT_C HBufC * | UniqueVendorNameL | ( | ) | |
Gets the unique vendor name of this package
VerifyControllerSignatureL(RPointerArray< CX509Certificate > &)
The function is used to re-verify the signature and certificate of the SIS Controller associated to the RSisRegistryEntry object.
aX509CertArray parameter is used to give set of trusted root certificates that are used for validation of the SIS Controller certificate. If the set given as parameter is empty, Symbian implementation can fetch the set of trusted root certificates from Certificate Management. If the set is not empty, then root certificates should not be fetched from Certificate Mgmt, but only the root certificates from the set given as parameter should be used for SIS Controller certificate validation.
VerifyControllerSignatureL(RPointerArray< CX509Certificate > &, TBool)
The function is used to re-verify the signature and certificate of the SIS Controller associated to the RSisRegistryEntry object.
aX509CertArray parameter is used to give set of trusted root certificates that are used for validation of the SIS Controller certificate. If the set given as parameter is empty, Symbian implementation can fetch the set of trusted root certificates from Certificate Management. If the set is not empty, then root certificates should not be fetched from Certificate Mgmt, but only the root certificates from the set given as parameter should be used for SIS Controller certificate validation.
Parameters
RPointerArray< CX509Certificate > & aX509CertArray | Array of trusted root certificates. |
TBool aCheckDateAndTime | Indicates if the certificate validity period should be checked against the current date and time. |
VersionL()
Gets the version of this package
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.