merge with master
[framework/osp/net.git] / inc / FNetNetAccountManager.h
index b0bdeba..12394f4 100755 (executable)
@@ -85,7 +85,9 @@ public:
         * Creates a new network account.
         *
         * @since                       2.0
-        * @privilege           %http://tizen.org/privilege/network.account
+        *
+        * @privlevel           public
+        * @privilege           http://tizen.org/privilege/network.account
         *
         * @return                      The @c NetAccountId assigned by the creation of a new network account, @n
         *                                      else @c INVALID_HANDLE if an error occurs
@@ -99,7 +101,9 @@ public:
         * @remarks                     This method creates a new network account and returns a @c NetAccountId value that can be used in method calls later to operate on the
         *                                      account. If @c INVALID_HANDLE is returned, the specific error code can be accessed using the GetLastResult() method. A Wi-Fi account
         *                                      cannot be created using %NetAccountManager.
-        * @see                         GetNetAccountInfoN(), UpdateNetAccount(), DeleteNetAccount()
+        * @see                         GetNetAccountInfoN()
+        * @see                         UpdateNetAccount()
+        * @see                         DeleteNetAccount()
         */
        NetAccountId CreateNetAccount(NetAccountInfo& netAccountInfo);
 
@@ -108,7 +112,9 @@ public:
         * If the account is read-only or in service, the deletion fails. The Wi-Fi accounts cannot be deleted by %NetAccountManager.
         *
         * @since               2.0
-        * @privilege   %http://tizen.org/privilege/network.account
+        *
+        * @privlevel   public
+        * @privilege   http://tizen.org/privilege/network.account
         *
         * @return              An error code
         * @param[in]   netAccountId            A NetAccountId instance containing valid account information
@@ -119,7 +125,9 @@ public:
         * @exception   E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
         * @remarks             If the network account is created by another application, this method fails.
         *                              This method must use a warning pop-up to notify the user.
-        * @see                 CreateNetAccount(), GetNetAccountInfoN(), UpdateNetAccount()
+        * @see                 CreateNetAccount()
+        * @see                 GetNetAccountInfoN()
+        * @see                 UpdateNetAccount()
         */
        result DeleteNetAccount(NetAccountId netAccountId);
 
@@ -127,7 +135,9 @@ public:
         * Updates an existing network account.
         *
         * @since                       2.0
-        * @privilege           %http://tizen.org/privilege/network.account
+        *
+        * @privlevel           public
+        * @privilege           http://tizen.org/privilege/network.account
         *
         * @return                      An error code
         * @param[in]           netAccountInfo          A NetAccountInfo instance containing network information to update an account
@@ -143,27 +153,30 @@ public:
         *                                      Before calling this method, the user must call GetNetAccountInfoN() to get the latest information in the registry
         *                                      and change the desired fields of that information.
         *                                      This method must use a warning pop-up to notify the user.
-        * @see                         CreateNetAccount(), GetNetAccountInfoN(), UpdateNetAccount(), DeleteNetAccount()
+        * @see                         CreateNetAccount()
+        * @see                         GetNetAccountInfoN()
+        * @see                         UpdateNetAccount()
+        * @see                         DeleteNetAccount()
         */
        result UpdateNetAccount(const NetAccountInfo& netAccountInfo);
 
        /**
-        * @if VISPARTNER-MANUFACTURER
         * Updates an existing system network account.
         *
-        * @since                  2.0
-        * @visibility             partner-manufacturer
-        * @privilege              %http://tizen.org/privilege/networkmanager
-        *
-        * @return                 An error code
-        * @param[in]              netAccountInfo             A NetAccountInfo instance containing network information to update an account
-        * @exception              E_SUCCESS                   The method is successful.
-        * @exception              E_INVALID_ARG             The specified input parameter is invalid.
-        * @exception              E_INVALID_ACCOUNT      The input account ID is invalid.
-        * @exception              E_OPERATION_FAILED     This request operation has failed due to an internal error.
-        * @exception              E_PRIVILEGE_DENIED     The application does not have the privilege to call this method.
-        * @see                    GetNetAccountInfoN(), UpdateNetAccount()
-        * @endif
+        * @since       2.0
+        *
+        * @privlevel   platform
+        * @privilege   http://tizen.org/privilege/networkmanager
+        *
+        * @return      An error code
+        * @param[in]   netAccountInfo         A NetAccountInfo instance containing network information to update an account
+        * @exception   E_SUCCESS              The method is successful.
+        * @exception   E_INVALID_ARG          The specified input parameter is invalid.
+        * @exception   E_INVALID_ACCOUNT      The input account ID is invalid.
+        * @exception   E_OPERATION_FAILED     This request operation has failed due to an internal error.
+        * @exception   E_PRIVILEGE_DENIED     The application does not have the privilege to call this method.
+        * @see         GetNetAccountInfoN()
+        * @see                 UpdateNetAccount()
         */
        result UpdateSystemNetAccount(const NetAccountInfo& netAccountInfo);
 
@@ -188,7 +201,9 @@ public:
         *                                      To determine the type of instance returned, use the GetBearerType() method.
         *                                      The instance can then be cast down to %WifiNetAccountInfo and used in a NET_BEARER_WIFI case. If the
         *                                      application gets the last result by E_INVALID_PROXY, it must use a warning pop-up to notify the user.
-        * @see                         CreateNetAccount(), UpdateNetAccount(), DeleteNetAccount()
+        * @see                         CreateNetAccount()
+        * @see                         UpdateNetAccount()
+        * @see                         DeleteNetAccount()
         */
        NetAccountInfo* GetNetAccountInfoN(NetAccountId netAccountId) const;
 
@@ -251,14 +266,12 @@ public:
        NetAccountId GetNetAccountId(NetBearerType netBearerType = NET_BEARER_PS) const;
 
        /**
-        * @if VISPARTNER
-        *
         * Gets a network account, which is set for the application like email, IM, and so on.
         *
         * @since               2.0
         *
-        * @visibility  partner
-        * @privilege   %http://tizen.org/privilege/customnetaccount
+        * @privlevel   partner
+        * @privilege   http://tizen.org/privilege/customnetaccount
         *
         * @return              The @c NetAccountID with the specified name, @n
         *                              else INVALID_HANDLE is returned in case of an error or if %NetAccountInfo is not found
@@ -268,19 +281,16 @@ public:
         * @exception   E_SYSTEM                        An internal error has occurred.
         * @exception   E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
-        * @endif
         */
        NetAccountId GetAppNetAccountId(const Tizen::Base::String& netProfileName) const;
 
        /**
-        * @if VISPARTNER
-        *
         * Sets the application-wise default account ID to the one specified by the input argument value.
         *
         * @since           2.0
         *
-        * @visibility          partner
-        * @privilege           %http://tizen.org/privilege/customnetaccount
+        * @privlevel           partner
+        * @privilege           http://tizen.org/privilege/customnetaccount
         *
         * @return                      An error code
         * @param[in]           netAccountId            The network account ID
@@ -288,8 +298,6 @@ public:
         * @exception           E_INVALID_ARG           The specified @c netAccountId is invalid.
         * @exception           E_SYSTEM                        An internal error has occurred.
         * @exception           E_PRIVILEGE_DENIED      The application does not have the privilege to call this method.
-        *
-        * @endif
         */
        result SetNetAccountId(NetAccountId netAccountId);
 
@@ -316,7 +324,9 @@ public:
         * @brief <i> [Deprecated] </i>
         * @deprecated          This method is deprecated because it is moved to the NetConnectionManager class.
         * @since                       2.0
-        * @privilege           %http://tizen.org/privilege/network.connection
+        *
+        * @privlevel           public
+        * @privilege           http://tizen.org/privilege/network.connection
         *
         * @return                      An error code
         * @param[in]           netPreference           The preferred network