1 /*

     1 /*

     3 * All rights reserved.

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Eclipse Public License v1.0"

     5 * under the terms of the License "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

    29 #define SOFTWARECOMPONENTREGISTRY_H

    29 #define SOFTWARECOMPONENTREGISTRY_H

    30 

    30 

    31 #include <e32base.h>

    31 #include <e32base.h>

    32 #include <usif/usifcommon.h>

    32 #include <usif/usifcommon.h>

    33 #include <usif/scr/screntries.h>

    33 #include <usif/scr/screntries.h>

    34 #include <scs/scsclient.h>

    35 #include <scs/scsclient.h>

    35 

    37 

    36 namespace Usif

    38 namespace Usif

    37 	{	 

    39 	{	 

    38 #ifdef SYMBIAN_ENABLE_SPLIT_HEADERS

    40 #ifdef SYMBIAN_ENABLE_SPLIT_HEADERS

    39 	class CScrLogEntry;

    41 	class CScrLogEntry;

   135 			

   137 			

   136 			N.B. This is a mutating function. Please see @see Usif::RSoftwareComponentRegistry.

   138 			N.B. This is a mutating function. Please see @see Usif::RSoftwareComponentRegistry.

   137 				

   139 				

   138 			@param aName The non-localizable name of the component being added.

   140 			@param aName The non-localizable name of the component being added.

   139 			@param aVendor The non-localizable vendor name of the component being added.

   141 			@param aVendor The non-localizable vendor name of the component being added.

   141 			@param aGlobalId A named, nullable, case-sensitive string used to specify a deterministic identifier for the component 

   143 			@param aGlobalId A named, nullable, case-sensitive string used to specify a deterministic identifier for the component 

   142 						that is unique within the context of that software type. The global component id might be 

   144 						that is unique within the context of that software type. The global component id might be 

   143 						the package UID for native applications or the MIDlet name/vendor pair for Java MIDLets, etc. 

   145 						the package UID for native applications or the MIDlet name/vendor pair for Java MIDLets, etc. 

   144 						Note that if KNullDesC is provided, the global identifier will be empty.

   146 						Note that if KNullDesC is provided, the global identifier will be empty.

   146 			@return  The component ID of the newly added entry.

   148 			@return  The component ID of the newly added entry.

   147 			

   149 			

   148 			@leave KErrScrWriteOperationInProgress If a transaction started by another session is in progress.

   150 			@leave KErrScrWriteOperationInProgress If a transaction started by another session is in progress.

   149 			@leave KErrScrReadOperationInProgress If a read operation with component or file views is in progress.

   151 			@leave KErrScrReadOperationInProgress If a read operation with component or file views is in progress.

   150 			@leave Or system-wide error codes.

   152 			@leave Or system-wide error codes.

   162 			@param aUniqueSwTypeName The non-localized, unique software type name, e.g. "Native".

   164 			@param aUniqueSwTypeName The non-localized, unique software type name, e.g. "Native".

   163 			@param aGlobalId A named, nullable, case-sensitive string used to specify a deterministic identifier for the component 

   165 			@param aGlobalId A named, nullable, case-sensitive string used to specify a deterministic identifier for the component 

   164 							that is unique within the context of that software type. The global component id would be 

   166 							that is unique within the context of that software type. The global component id would be 

   165 							the package UID for native applications or the midlet-names for Java, etc. 

   167 							the package UID for native applications or the midlet-names for Java, etc. 

   166 							Note that if KNullDesC is provided, the global identifier will be empty.

   168 							Note that if KNullDesC is provided, the global identifier will be empty.

   168 			@return  The component ID of the newly added entry. 

   170 			@return  The component ID of the newly added entry. 

   169 			

   171 			

   170 			@leave KErrScrWriteOperationInProgress If a transaction started by another session is in progress.

   172 			@leave KErrScrWriteOperationInProgress If a transaction started by another session is in progress.

   171 			@leave KErrScrReadOperationInProgress If a read operation with component or file views is in progress.

   173 			@leave KErrScrReadOperationInProgress If a read operation with component or file views is in progress.

   172 			@leave Or system-wide error codes.

   174 			@leave Or system-wide error codes.

   553 		    @leave System-wide error codes.

   555 		    @leave System-wide error codes.

   554 	     */

   556 	     */

   555 		IMPORT_C TBool GetComponentL(TComponentId aComponentId, CComponentEntry& aEntry, TLanguage aLocale=KUnspecifiedLocale) const;							

   557 		IMPORT_C TBool GetComponentL(TComponentId aComponentId, CComponentEntry& aEntry, TLanguage aLocale=KUnspecifiedLocale) const;							

   556 		

   558 		

   557 		/**

   559 		/**

   559 							

   561 							

   560 			@param aComponentId The unique ID of the given software component.

   562 			@param aComponentId The unique ID of the given software component.

   561 			@param aCompLocalizedInfoArray An output parameter for returning localized information for a given component id. 

   563 			@param aCompLocalizedInfoArray An output parameter for returning localized information for a given component id. 

   562 			@leave System-wide error codes.

   564 			@leave System-wide error codes.

   563 			@capability  ReadUserData Accessing a component's localized information requires ReadUserData

   565 			@capability  ReadUserData Accessing a component's localized information requires ReadUserData

   579 		

   581 		

   580 		/**

   582 		/**

   581 			Retrieves the local component id of a given global component id.

   583 			Retrieves the local component id of a given global component id.

   582 			

   584 			

   583 			@param aGlobalIdName A deterministic identifier for the component that is unique within the context of that software type.

   585 			@param aGlobalIdName A deterministic identifier for the component that is unique within the context of that software type.

   585 			@return The local unique component id.

   587 			@return The local unique component id.

   586 			

   588 			

   587 			@leave KErrNotFound Software component with this global id is not present in the system.

   589 			@leave KErrNotFound Software component with this global id is not present in the system.

   588 			@leave System-wide error codes.

   590 			@leave System-wide error codes.

   589 		 */

   591 		 */

   591 					

   593 					

   592 		/**

   594 		/**

   593 			Retrieves a specific software component entry with the specified global id and software type name for a given locale. 

   595 			Retrieves a specific software component entry with the specified global id and software type name for a given locale. 

   594 							

   596 							

   595 			@param aGlobalIdName A deterministic identifier for the component that is unique within the context of that software type.

   597 			@param aGlobalIdName A deterministic identifier for the component that is unique within the context of that software type.

   597 			@param aLocale The language code of the requested locale. The default value is KUnspecifiedLocale.

   599 			@param aLocale The language code of the requested locale. The default value is KUnspecifiedLocale.

   598 						   If KUnspecifiedLocale is provided, the current locale with its downgraded path (@see BaflUtils::GetDowngradePathL) is used to find

   600 						   If KUnspecifiedLocale is provided, the current locale with its downgraded path (@see BaflUtils::GetDowngradePathL) is used to find

   599 						   the names. If it fails, then the non-localized names are returned. If non-localized versions

   601 						   the names. If it fails, then the non-localized names are returned. If non-localized versions

   600 						   couldn't be found too, the first available language for the component is retrieved.

   602 						   couldn't be found too, the first available language for the component is retrieved.

   601 						   If KNonLocalized is provided, then the non-localized component and vendor names are returned,

   603 						   If KNonLocalized is provided, then the non-localized component and vendor names are returned,

   691 						   If a particular language is provided, then the property is searched for this particular language

   693 						   If a particular language is provided, then the property is searched for this particular language

   692 						   and its downgraded languages. If there is no property with the provided language, then the function 

   694 						   and its downgraded languages. If there is no property with the provided language, then the function 

   693 						   leaves with KErrNotFound.

   695 						   leaves with KErrNotFound.

   694 			@return Returns a pointer to the property object containing the requested component property entry.

   696 			@return Returns a pointer to the property object containing the requested component property entry.

   695 					The ownership is transferred. If the property couldn't be found, then NULL is returned.

   697 					The ownership is transferred. If the property couldn't be found, then NULL is returned.

   697 		 */

   699 		 */

   698 		IMPORT_C CPropertyEntry* GetComponentPropertyL(TComponentId aComponentId, const TDesC& aPropertyName, TLanguage aLocale=KUnspecifiedLocale) const;

   700 		IMPORT_C CPropertyEntry* GetComponentPropertyL(TComponentId aComponentId, const TDesC& aPropertyName, TLanguage aLocale=KUnspecifiedLocale) const;

   699 		

   701 		

   700 		/**

   702 		/**

   701 			Retrieves the set of properties for a particular locale belonging to the given component.

   703 			Retrieves the set of properties for a particular locale belonging to the given component.

   711 						   If non-localized versions couldn't be found too, the function leaves with KErrNotFound.

   713 						   If non-localized versions couldn't be found too, the function leaves with KErrNotFound.

   712 						   If KNonLocalized is provided, then the non-localized versions of properties are returned,

   714 						   If KNonLocalized is provided, then the non-localized versions of properties are returned,

   713 						   If non-localized versions don't exist, then the function will leave with KErrNotFound.

   715 						   If non-localized versions don't exist, then the function will leave with KErrNotFound.

   714 						   If a particular language is provided, then the properties are searched for this particular language

   716 						   If a particular language is provided, then the properties are searched for this particular language

   715 						   and its downgraded languages. Otherwise, the function leaves with KErrNotFound.

   717 						   and its downgraded languages. Otherwise, the function leaves with KErrNotFound.

   717 		*/

   719 		*/

   718 		IMPORT_C void GetComponentPropertiesL(TComponentId aComponentId, RPointerArray<CPropertyEntry>& aProperties, TLanguage aLocale=KUnspecifiedLocale) const;

   720 		IMPORT_C void GetComponentPropertiesL(TComponentId aComponentId, RPointerArray<CPropertyEntry>& aProperties, TLanguage aLocale=KUnspecifiedLocale) const;

   719 				

   721 				

   720 		/**

   722 		/**

   721 			Returns whether all drives registered for the given component are present.

   723 			Returns whether all drives registered for the given component are present.

   733 		/** 

   735 		/** 

   734 			Sets the SCOMO state of a given component.

   736 			Sets the SCOMO state of a given component.

   735 			

   737 			

   736 			@param aComponentId The unique ID of the given software component. 	

   738 			@param aComponentId The unique ID of the given software component. 	

   737 			@param aScomoState The new SCOMO state of the component.

   739 			@param aScomoState The new SCOMO state of the component.

   739 		 */

   741 		 */

   740 		IMPORT_C void SetScomoStateL(TComponentId aComponentId, TScomoState aScomoState) const;

   742 		IMPORT_C void SetScomoStateL(TComponentId aComponentId, TScomoState aScomoState) const;

   741 		

   743 		

   742 		/** 

   744 		/** 

   743 			Retrieves the UID of the plug-in which is responsible for a given MIME type.

   745 			Retrieves the UID of the plug-in which is responsible for a given MIME type.

   744 					

   746 					

   745 			@param aMimeType The MIME type. 	

   747 			@param aMimeType The MIME type. 	

   746 			@return The UID of the plug-in.

   748 			@return The UID of the plug-in.

   747 			@leave KErrSifUnsupportedSoftwareType There is no corresponding plug-in for this MIME type.

   749 			@leave KErrSifUnsupportedSoftwareType There is no corresponding plug-in for this MIME type.

   749 			@internalTechnology

   751 			@internalTechnology

   750 		 */

   752 		 */

   751 		IMPORT_C TUid GetPluginUidL(const TDesC& aMimeType) const;

   753 		IMPORT_C TUid GetPluginUidL(const TDesC& aMimeType) const;

   752 		

   754 		

   753 		/** 

   755 		/** 

   754 			Retrieves the UID of the plug-in that installed a given component.

   756 			Retrieves the UID of the plug-in that installed a given component.

   755 							

   757 							

   756 			@param aComponentId Component's local identifier. 	

   758 			@param aComponentId Component's local identifier. 	

   757 			@return The UID of the plug-in.

   759 			@return The UID of the plug-in.

   759 			@internalTechnology

   761 			@internalTechnology

   760 		 */

   762 		 */

   761 		IMPORT_C TUid GetPluginUidL(TComponentId aComponentId) const;

   763 		IMPORT_C TUid GetPluginUidL(TComponentId aComponentId) const;

   762 		

   764 		

   763 		/**

   765 		/**

   771 			@param aExecutionLayerSecureId The secure id of the installer's execution layer which refers to an executable that interprets or  

   773 			@param aExecutionLayerSecureId The secure id of the installer's execution layer which refers to an executable that interprets or  

   772 			                               executes byte code for programs written in a high level language Java, Python, Widgets, etc.

   774 			                               executes byte code for programs written in a high level language Java, Python, Widgets, etc.

   773 			                               This paramater is optional. If it doesn't exist, it should be equal to the installer's secure id.                                

   775 			                               This paramater is optional. If it doesn't exist, it should be equal to the installer's secure id.                                

   774 			@param aMimeTypes The list of MIME types associated with this software type.

   776 			@param aMimeTypes The list of MIME types associated with this software type.

   775 			@param aLocalizedSwTypeNames A pointer to the list of optional localized software type names.

   777 			@param aLocalizedSwTypeNames A pointer to the list of optional localized software type names.

   777 			@internalTechnology

   779 			@internalTechnology

   778 		 */

   780 		 */

   779 		IMPORT_C void AddSoftwareTypeL(const TDesC& aUniqueSwTypeName, TUid aSifPluginUid, TSecureId aInstallerSecureId, TSecureId aExecutionLayerSecureId, const RPointerArray<HBufC>& aMimeTypes, const RPointerArray<CLocalizedSoftwareTypeName>* aLocalizedSwTypeNames = NULL);

   781 		IMPORT_C void AddSoftwareTypeL(const TDesC& aUniqueSwTypeName, TUid aSifPluginUid, TSecureId aInstallerSecureId, TSecureId aExecutionLayerSecureId, const RPointerArray<HBufC>& aMimeTypes, const RPointerArray<CLocalizedSoftwareTypeName>* aLocalizedSwTypeNames = NULL);

   780 		

   782 		

   781 		/**

   783 		/**

   784 			N.B. This is a mutating function. Please see @see Usif::RSoftwareComponentRegistry.

   786 			N.B. This is a mutating function. Please see @see Usif::RSoftwareComponentRegistry.

   785 			N.B. If the software type doesn't exist, the function completes successfully.

   787 			N.B. If the software type doesn't exist, the function completes successfully.

   786 			

   788 			

   787 			@param aUniqueSwTypeName Non-localized unique software type name.

   789 			@param aUniqueSwTypeName Non-localized unique software type name.

   788 			@param aDeletedMimeTypes An output parameter, where the MIME types deleted from SCR as a result of this operation will be stored.

   790 			@param aDeletedMimeTypes An output parameter, where the MIME types deleted from SCR as a result of this operation will be stored.

   790 			@internalTechnology

   792 			@internalTechnology

   791 		 */

   793 		 */

   792 		IMPORT_C void DeleteSoftwareTypeL(const TDesC& aUniqueSwTypeName, RPointerArray<HBufC>& aDeletedMimeTypes);

   794 		IMPORT_C void DeleteSoftwareTypeL(const TDesC& aUniqueSwTypeName, RPointerArray<HBufC>& aDeletedMimeTypes);

   793 	

   795 	

   794 		/**

   796 		/**

   795 			Returns whether the software installer of a given component is present.

   797 			Returns whether the software installer of a given component is present.

   796 					

   798 					

   797 			@param aComponentId The unique ID of the given software component. 

   799 			@param aComponentId The unique ID of the given software component. 

   798 			@return ETrue, if the software installer of the given component is present; otherwise EFalse.

   800 			@return ETrue, if the software installer of the given component is present; otherwise EFalse.

   800 		 */

   802 		 */

   801 		IMPORT_C TBool IsComponentOrphanedL(TComponentId aComponentId);

   803 		IMPORT_C TBool IsComponentOrphanedL(TComponentId aComponentId);

   802 		

   804 		

   803 		 /**

   805 		 /**

   804 			Retrieve the log entries recorded by SCR. A log entry (@see Usif::CScrLogEntry) contains information 

   806 			Retrieve the log entries recorded by SCR. A log entry (@see Usif::CScrLogEntry) contains information 

   807 			@param aLogEntries The caller supplies an empty array of CScrLogEntry which is loaded

   809 			@param aLogEntries The caller supplies an empty array of CScrLogEntry which is loaded

   808 					with the log entries from the SCR. If the SCR Log is empty then the array count 

   810 					with the log entries from the SCR. If the SCR Log is empty then the array count 

   809 					will be zero. The caller is responsible for deleting all memory.

   811 					will be zero. The caller is responsible for deleting all memory.

   810 			@param aUniqueSwTypeName Optional parameter for non-localized unique software type name.

   812 			@param aUniqueSwTypeName Optional parameter for non-localized unique software type name.

   811 									 If provided, only the log entries of the given software type are returned.

   813 									 If provided, only the log entries of the given software type are returned.

   813 			@capability ReadUserData

   815 			@capability ReadUserData

   814 		 */

   816 		 */

   815 		IMPORT_C void RetrieveLogEntriesL(RPointerArray<CScrLogEntry>& aLogEntries, const TDesC* aUniqueSwTypeName=NULL) const;

   817 		IMPORT_C void RetrieveLogEntriesL(RPointerArray<CScrLogEntry>& aLogEntries, const TDesC* aUniqueSwTypeName=NULL) const;

   816 		

   818 		

   817 		/**

   819 		/**

   820 			@param aVersionLeft The version on the left side of the equality.

   822 			@param aVersionLeft The version on the left side of the equality.

   821 			@param aVersionRight The version on the right side of the equality.

   823 			@param aVersionRight The version on the right side of the equality.

   822 			@return A positive value indicates that the left version is greater than the right version. 

   824 			@return A positive value indicates that the left version is greater than the right version. 

   823 				    A negative value indicates that the left version is less than the right version. 

   825 				    A negative value indicates that the left version is less than the right version. 

   824 				    Zero indicates that the left and right versions are equal. 

   826 				    Zero indicates that the left and right versions are equal. 

   826 		 */

   828 		 */

   827 		IMPORT_C static TInt CompareVersionsL(const TDesC& aVersionLeft, const TDesC& aVersionRight);

   829 		IMPORT_C static TInt CompareVersionsL(const TDesC& aVersionLeft, const TDesC& aVersionRight);

   828 

   830 

   829 		/**

   831 		/**

   830 			Returns whether the component is on a read-only drive.

   832 			Returns whether the component is on a read-only drive.

   831 

   833 

   832 			@param aComponentId The unique ID of the software component. 

   834 			@param aComponentId The unique ID of the software component. 

   833 			@return ETrue, if the component is present on a read only drive; otherwise EFalse.

   835 			@return ETrue, if the component is present on a read only drive; otherwise EFalse.

   835 		 */

   837 		 */

   836 		IMPORT_C TBool IsComponentOnReadOnlyDriveL(TComponentId aComponentId) const;

   838 		IMPORT_C TBool IsComponentOnReadOnlyDriveL(TComponentId aComponentId) const;

   837 		

   839 		

   838 		/**

   840 		/**

   839 			Returns whether the component is present on the device. As a component might be 

   841 			Returns whether the component is present on the device. As a component might be 

   845 			might not be updated immediately when a media card is replaced.

   847 			might not be updated immediately when a media card is replaced.

   846 			

   848 			

   847 			@param aComponentId The unique ID of the component.

   849 			@param aComponentId The unique ID of the component.

   848 			@return ETrue, if the component is present; otherwise EFalse.

   850 			@return ETrue, if the component is present; otherwise EFalse.

   849 			

   851 			

   851 		 */

   853 		 */

   852 		IMPORT_C TBool IsComponentPresentL(TComponentId aComponentId) const;

   854 		IMPORT_C TBool IsComponentPresentL(TComponentId aComponentId) const;

   853 		

   855 		

   854 		/**

   856 		/**

   855 			Sets whether the software component is present fully after being installed on to a 

   857 			Sets whether the software component is present fully after being installed on to a 

   860 			@param aComponentId The unique ID of the given software component.

   862 			@param aComponentId The unique ID of the given software component.

   861 			@param aValue ETrue to set component as present. EFalse to set component as not present.

   863 			@param aValue ETrue to set component as present. EFalse to set component as not present.

   862 			

   864 			

   863 			@leave KErrScrWriteOperationInProgress If a transaction started by another session is in progress.

   865 			@leave KErrScrWriteOperationInProgress If a transaction started by another session is in progress.

   864 			@leave KErrScrReadOperationInProgress If a read operation with component or file views is in progress.

   866 			@leave KErrScrReadOperationInProgress If a read operation with component or file views is in progress.

   866 		 */

   868 		 */

   867 		IMPORT_C void SetIsComponentPresentL(TComponentId aComponentId, TBool aValue);

   869 		IMPORT_C void SetIsComponentPresentL(TComponentId aComponentId, TBool aValue);

   868 		

   870 		

   869 		/**

   871 		/**

   870 			Gets the installed supported language ID's array.

   872 			Gets the installed supported language ID's array.

   871 

   873 

   872 			@param aComponentId The unique ID of the given software component.

   874 			@param aComponentId The unique ID of the given software component.

   873 			@param aMatchingSupportedLanguages RArray containing the list of installed supported languages

   875 			@param aMatchingSupportedLanguages RArray containing the list of installed supported languages

   874 			

   876 			

   877 		 */

   879 		 */

   878 		IMPORT_C void GetComponentSupportedLocalesListL(TComponentId aComponentId, RArray<TLanguage>& aMatchingSupportedLanguages) const;

   880 		IMPORT_C void GetComponentSupportedLocalesListL(TComponentId aComponentId, RArray<TLanguage>& aMatchingSupportedLanguages) const;

   879 		

   881 		

   880 	private:

   943 	private:

   881 

   944 

   882 		TInt SendSyncMessage(TInt aFunction, const TIpcArgs& aArgs) const;

   945 		TInt SendSyncMessage(TInt aFunction, const TIpcArgs& aArgs) const;

   883 		template <class C> void SendDependencyArgsL(TInt aFunction, const C& aSupplierId, const CGlobalComponentId& aDependantGlobalCompId);

   946 		template <class C> void SendDependencyArgsL(TInt aFunction, const C& aSupplierId, const CGlobalComponentId& aDependantGlobalCompId);

   884 		template <class C> friend HBufC8* GetObjectDataLC(const C& aConnection, TInt aFunction, TInt aDataSize);

   947 		template <class C> friend HBufC8* GetObjectDataLC(const C& aConnection, TInt aFunction, TInt aDataSize);

   946 						   and its downgraded languages. If there is no name and vendor with the provided language, 

  1009 						   and its downgraded languages. If there is no name and vendor with the provided language, 

   947 						   then the function leaves with KErrScrUnsupportedLocale.

  1010 						   then the function leaves with KErrScrUnsupportedLocale.

   948 			@return Returns the next component matching the given filter. If no more components can be found, returns NULL.

  1011 			@return Returns the next component matching the given filter. If no more components can be found, returns NULL.

   949 				     The ownership is transferred to the calling client.	     

  1012 				     The ownership is transferred to the calling client.	     

   950 			@leave KErrScrUnsupportedLocale The requested component name/vendor couldn't be found for the specified locale.

  1013 			@leave KErrScrUnsupportedLocale The requested component name/vendor couldn't be found for the specified locale.

   952 

  1015 

   953 			@capability  ReadUserData Accessing list of components installed by the user requires ReadUserData

  1016 			@capability  ReadUserData Accessing list of components installed by the user requires ReadUserData

   954 		 */

  1017 		 */

   955 		IMPORT_C CComponentEntry* NextComponentL(TLanguage aLocale=KUnspecifiedLocale) const;

  1018 		IMPORT_C CComponentEntry* NextComponentL(TLanguage aLocale=KUnspecifiedLocale) const;

   956 		

  1019 		

   970 						   If a particular language is provided, then the names are searched for this particular language

  1033 						   If a particular language is provided, then the names are searched for this particular language

   971 						   and its downgraded languages. If there is no name and vendor with the provided language, 

  1034 						   and its downgraded languages. If there is no name and vendor with the provided language, 

   972 						   then the function leaves with KErrScrUnsupportedLocale.		

  1035 						   then the function leaves with KErrScrUnsupportedLocale.		

   973 			@return EFalse, if the end of the view has been reached. Otherwise, ETrue.  		

  1036 			@return EFalse, if the end of the view has been reached. Otherwise, ETrue.  		

   974 			@leave KErrScrUnsupportedLocale The requested component name/vendor couldn't be found for the specified locale.

  1037 			@leave KErrScrUnsupportedLocale The requested component name/vendor couldn't be found for the specified locale.

   976 

  1039 

   977 			@capability  ReadUserData Accessing list of components installed by the user requires ReadUserData

  1040 			@capability  ReadUserData Accessing list of components installed by the user requires ReadUserData

   978 	     */

  1041 	     */

   979 		IMPORT_C TBool NextComponentL(CComponentEntry& aEntry, TLanguage aLocale=KUnspecifiedLocale) const;				

  1042 		IMPORT_C TBool NextComponentL(CComponentEntry& aEntry, TLanguage aLocale=KUnspecifiedLocale) const;				

   980 		

  1043 		

   995 						   and if non-localized versions don't exist, the function will leave with KErrScrUnsupportedLocale.

  1058 						   and if non-localized versions don't exist, the function will leave with KErrScrUnsupportedLocale.

   996 						   If a particular language is provided, then the names are searched for this particular language

  1059 						   If a particular language is provided, then the names are searched for this particular language

   997 						   and its downgraded languages. If there is no name and vendor with the provided language, 

  1060 						   and its downgraded languages. If there is no name and vendor with the provided language, 

   998 						   then the function leaves with KErrScrUnsupportedLocale.		

  1061 						   then the function leaves with KErrScrUnsupportedLocale.		

   999 			@leave KErrScrUnsupportedLocale The requested component name/vendor couldn't be found for the specified locale.

  1062 			@leave KErrScrUnsupportedLocale The requested component name/vendor couldn't be found for the specified locale.

  1001 

  1064 

  1002 			@capability  ReadUserData Accessing list of components installed by the user requires ReadUserData

  1065 			@capability  ReadUserData Accessing list of components installed by the user requires ReadUserData

  1003 		 */

  1066 		 */

  1004 		IMPORT_C void NextComponentSetL(TInt aMaxCount, RPointerArray<CComponentEntry>& aComponentList, TLanguage aLocale=KUnspecifiedLocale) const;

  1067 		IMPORT_C void NextComponentSetL(TInt aMaxCount, RPointerArray<CComponentEntry>& aComponentList, TLanguage aLocale=KUnspecifiedLocale) const;

  1005 	

  1068 	

  1006 	private:

  1069 	private:

  1007 		TInt SendSyncMessage(TInt aFunction, const TIpcArgs& aArgs) const;

  1071 		TInt SendSyncMessage(TInt aFunction, const TIpcArgs& aArgs) const;

  1008 		template <class C> friend HBufC8* GetObjectDataLC(const C& aConnection, TInt aFunction, TInt aDataSize);

  1072 		template <class C> friend HBufC8* GetObjectDataLC(const C& aConnection, TInt aFunction, TInt aDataSize);

  1009 		template <class T, class C> friend TBool GetObjectL(const C& aConnection, T& aObject, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs);

  1073 		template <class T, class C> friend TBool GetObjectL(const C& aConnection, T& aObject, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs);

  1010 		template <class C, class T> friend void GetObjectArrayL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs, RArray<T>& aArray);

  1074 		template <class C, class T> friend void GetObjectArrayL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs, RArray<T>& aArray);

  1011 		template <class C, class T> friend void GetObjectArrayL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs, RPointerArray<T>& aArray);

  1075 		template <class C, class T> friend void GetObjectArrayL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs, RPointerArray<T>& aArray);

  1017 	 */

  1081 	 */

  1018 		{

  1082 		{

  1019 	public:

  1083 	public:

  1020 		/**

  1084 		/**

  1021 			Default constructor of registry file list sub-session.

  1085 			Default constructor of registry file list sub-session.

  1023 		IMPORT_C RSoftwareComponentRegistryFilesList();

  1087 		IMPORT_C RSoftwareComponentRegistryFilesList();

  1024 		

  1088 		

  1025 		/**

  1089 		/**

  1026 			Closes the registry view on the SCR server.

  1090 			Closes the registry view on the SCR server.

  1027 		 */

  1091 		 */

  1061 			@leave A system-wide error code.

  1125 			@leave A system-wide error code.

  1062 		 */

  1126 		 */

  1063 		IMPORT_C void NextFileSetL(TInt aMaxCount, RPointerArray<HBufC>& aFileList) const;

  1127 		IMPORT_C void NextFileSetL(TInt aMaxCount, RPointerArray<HBufC>& aFileList) const;

  1064 	

  1128 	

  1065 	private:

  1129 	private:

  1066 		TInt SendSyncMessage(TInt aFunction, const TIpcArgs& aArgs) const;

  1131 		TInt SendSyncMessage(TInt aFunction, const TIpcArgs& aArgs) const;

  1067 		template <class C> friend HBufC8* GetObjectDataLC(const C& aConnection, TInt aFunction, TInt aDataSize);

  1132 		template <class C> friend HBufC8* GetObjectDataLC(const C& aConnection, TInt aFunction, TInt aDataSize);

  1068 		template <class T, class C> friend T* GetObjectL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs);

  1133 		template <class T, class C> friend T* GetObjectL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs);

  1069 		template <class C, class T> friend void GetObjectArrayL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs, RPointerArray<T>& aArray);

  1134 		template <class C, class T> friend void GetObjectArrayL(const C& aConnection, TInt aSizeFunction, TInt aDataFunction, TInt aArgNum, TIpcArgs& aArgs, RPointerArray<T>& aArray);

  1074 #endif // SOFTWARECOMPONENTREGISTRY_H

  1497 #endif // SOFTWARECOMPONENTREGISTRY_H