Enable build with iniparser v 3.1
[platform/framework/native/appfw.git] / inc / FSecPrivilegeInfo.h
index a7816b2..af5a82b 100755 (executable)
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2013 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -24,9 +23,9 @@
 
 #ifndef _FSEC_PRIVILEGE_INFO_H_
 #define _FSEC_PRIVILEGE_INFO_H_
+
 #include <FBaseObject.h>
+
 namespace Tizen { namespace Security
 {
 
@@ -34,14 +33,14 @@ class _PrivilegeInfoImpl;
 
 /**
 * @class       PrivilegeInfo
-* @brief       This class represents the privilege information.
+* @brief       This class provides methods for managing the privilege information.
 *
 * @since       2.1
 *
 * @final       This class is not intended for extension.
 *
 * The %PrivilegeInfo class represents the privilege information.
-* %PrivilegeInfo provides methods to retrieve the name and description of privilege.
+* This class provides methods to retrieve the name and description of privilege.
 *
 */
 
@@ -51,40 +50,10 @@ class _OSP_EXPORT_ PrivilegeInfo
 public:
 
        /**
-        * Gets the name of a privilege.
-        *
-        * @since       2.1
-        *
-        * @return              The name of a privilege, else an empty string is returned if there is no value.
-        * @exception   E_SUCCESS                       The method is successful.
-        * @exception   E_SYSTEM                        An unexpected system error occurred.
-        * @exception   E_INVALID_ARG           The specified input privilege string is invalid.
-        * @exception   E_DATA_NOT_FOUND        The privilege information does not exist.
-        * @remarks             The specific error code can be accessed using the GetLastResult() method.
-        */
-       static Tizen::Base::String GetName(const Tizen::Base::String& privilege);
-
-       /**
-        * Gets the description of a privilege.
-        *
-        * @since               2.1
-        *
-        * @return              The description of a privilege, else an empty string is returned if there is no value.
-        * @exception   E_SUCCESS                       The method is successful.
-        * @exception   E_SYSTEM                        An unexpected system error occurred.
-        * @exception   E_INVALID_ARG           The specified input privilege string is invalid.
-        * @exception   E_DATA_NOT_FOUND        The privilege information does not exist.
-        * @remarks             The specific error code can be accessed using the GetLastResult() method.
-        */
-       static Tizen::Base::String GetDescription(const Tizen::Base::String& privilege);
-
-       /**
         * The object is not fully constructed after this constructor is called. @n
         * For full construction, the Construct() method must be called right after calling this constructor.
         *
-        * @since       2.1
-        *
-        * @remarks  After creating an instance of this class, the Construct() method must be called explicitly to initialize this instance.
+        * @since               2.1
         */
        PrivilegeInfo(void);
 
@@ -99,22 +68,22 @@ public:
        /**
         * Initializes this instance of %PrivilegeInfo with the specified parameters.
         *
-        * @since         2.1
+        * @since               2.1
         *
-        * @return       An error code
-        * @param[in]   privilegeId                The privilege ID
-        * @exception   E_SUCCESS               The method is successful.
-        * @exception   E_INVALID_ARG          The specified @c privilegeId is invalid.
+        * @return              An error code
+        * @param[in]   privilegeId                             The privilege ID
+        * @exception   E_SUCCESS                               The method is successful.
+        * @exception   E_INVALID_ARG                   The specified @c privilegeId is invalid.
         *
         */
        result Construct(const Tizen::Base::String& privilegeId);
 
        /**
-        * Gets a privilege ID.
+        * Gets the privilege ID.
         *
-        * @since              2.1
+        * @since               2.1
         *
-        * @return            The privilege ID.
+        * @return              The privilege ID
         *
         */
        Tizen::Base::String GetId(void) const;
@@ -122,9 +91,10 @@ public:
        /**
         * Gets the localized display name of privilege.
         *
-        * @since              2.1
+        * @since               2.1
         *
-        * @return            The display name of privilege, else an empty string is returned if there is no value.
+        * @return              The display name of privilege, @n
+        *                              else an empty string is returned if there is no value
         *
         */
        Tizen::Base::String GetDisplayName(void) const;
@@ -132,9 +102,10 @@ public:
        /**
         * Gets the localized description of privilege.
         *
-        * @since              2.1
+        * @since               2.1
         *
-        * @return            The description of privilege, else an empty string is returned if there is no value.
+        * @return              The description of privilege, @n
+        *                              else an empty string is returned if there is no value
         *
         */
        Tizen::Base::String GetDescription(void) const;
@@ -144,19 +115,19 @@ private:
        //
        // The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
        //
-       // @param[in]   rhs         An instance of %PrivilegeInfo
+       // @param[in]   rhs             An instance of %PrivilegeInfo
        //
        PrivilegeInfo(const PrivilegeInfo& rhs);
 
        //
        // The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
        //
-       // @param[in]   rhs An instance of %PrivilegeInfo
+       // @param[in]   rhs             An instance of %PrivilegeInfo
        //
        PrivilegeInfo& operator =(const PrivilegeInfo& rhs);
 
 private:
-       static class _PrivilegeInfoImpl* __pPrivilegeInfoImpl;
+
        class _PrivilegeInfoImpl * __pImpl;
        friend class _PrivilegeInfoImpl;