Add to retry to read DUID.

[platform/framework/native/appfw.git] / inc / FSecPkcsPkcs08AttributeValue.h

diff --git a/inc/FSecPkcsPkcs08AttributeValue.h b/inc/FSecPkcsPkcs08AttributeValue.h
old mode 100644 (file)
new mode 100755 (executable)
index e70f729..2333152
--- a/inc/FSecPkcsPkcs08AttributeValue.h
+++ b/inc/FSecPkcsPkcs08AttributeValue.h
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2013 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -34,10 +33,13 @@ namespace Tizen { namespace Security { namespace Pkcs
 
 /**
  * @class              Pkcs08AttributeValue
- * @brief              This class implements the functionalities specified by the Pkcs08AttributeValue class.
- * @brief              Pkcs08AttributeValue object will consist of the value of an attribute and the tag value.
+ * @brief              This class implements the functionalities specified by the %Pkcs08AttributeValue class.
+ * 
  * @since              2.1
  *
+ * The %Pkcs08AttributeValue class implements the functionalities specified by the %Pkcs08AttributeValue class.
+ * The %Pkcs08AttributeValue object consists of an attribute value and a tag value.
+ *
  */
 class _OSP_EXPORT_ Pkcs08AttributeValue
        : public Tizen::Base::Object
@@ -59,61 +61,61 @@ public:
        virtual ~Pkcs08AttributeValue(void);
 
        /**
-        * Intializes this instance of %Pkcs08AttributeValue with the Bytebuffer which contain  AttributeValue @n
-        * (contain tag i.e. Ans1_Type and the value)
+        * Initializes this instance of %Pkcs08AttributeValue with the Tizen::Base::ByteBuffer that contains the AttributeValue @n
+        * (contain tag, that is, Ans1_Type and the value).
         *
         * @since               2.1
         *
         * @return              An error code
-        * @param[in]   encodedData                             DER encoded Bytebuffer of AttrributeValue.
+        * @param[in]   encodedData                             The DER encoded Tizen::Base::ByteBuffer of AttributeValue
         * @exception   E_SUCCESS                                       The method is successful.
         * @exception   E_INVALID_ARG                   The specified input parameter is invalid.
         */
        result Construct(const Tizen::Base::ByteBuffer& encodedData);
 
        /**
-        * Intializes this instance of %Pkcs08AttributeValue with specified parameters.
-        * This API implements the Construct API which initializes the attribute value instance based on passed byte buffer.
+        * Initializes this instance of %Pkcs08AttributeValue with the specified parameters. @n
+        * The %Construct() method initializes the attribute value instance based on the byte buffer passed.
         *
         * @since               2.1
         *
         * @return              An error code
-        * @param[in]   value                                   An instance of ByteBuffer, holding raw value. @n
-        * @param[in]   tag                                             Tag holding the tag type. This tag number is assigned by ASN1 standards for @n
+        * @param[in]   value                                   An instance of Tizen::Base::ByteBuffer holding raw value
+        * @param[in]   tag                                             A tag holding the tag type @n This tag number is assigned by ASN1 standards for @n
         *                                                                                                      basic data types.
         * @exception   E_SUCCESS                               The method is successful.
-        * @exception   E_INVALID_ARG           The specified input parameter is invalid.
+        * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         */
-       result Construct(const Tizen::Base::ByteBuffer& value, const Pkcs08TagValue tag);
+       result Construct(const Tizen::Base::ByteBuffer& value, Pkcs08TagValue tag);
 
        /**
-        * Get the reference to the ByteBuffer contains the attribute value.
+        * Gets a reference to Tizen::Base::ByteBuffer that contains the attribute value.
         *
         * @since               2.1
         *
-        * @return              A reference to ByteBuffer,containing raw value.
+        * @return              A reference to Tizen::Base::ByteBuffer containing raw value
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
        const Tizen::Base::ByteBuffer& GetValue(void) const;
 
        /**
-        * Get the tag value of an attribute.
-        * This tag number is assigned by ASN1 standards for basic data types..
+        * Gets the tag value of an attribute. @n
+        * This tag number is assigned by ASN1 standards for basic data types.
         *
         * @since               2.1
         *
-        * @return              Tag value that is assigned by ASN1 standards for basic data types.
+        * @return              The tag value that is assigned by ASN1 standards for basic data types
         */
        Pkcs08TagValue GetTag(void) const;
 
        /**
-        * Gets the pointer to the ByteBuffer that contains the attribute value in encoded format.
-        * It is assumed that each Pkcs08Attribute will have only a single form of encoding example ASN.1 DER.
+        * Gets a pointer to Tizen::Base::ByteBuffer that contains the attribute value in encoded format. @n
+        * It is assumed that each Pkcs08Attribute will have only a single form of encoding, for example, ASN.1 DER.
         *
         * @since               2.1
         *
-        * @return              A pointer to the ByteBuffer class that contains the output, @n
-        *                                              else @c null if an error occurs.
+        * @return              A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+        *                                              else @c null if an error occurs
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_SYSTEM                                The method cannot proceed due to a severe system error.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.