X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;ds=sidebyside;f=inc%2FFSecPkcsAlgorithmIdentifier.h;h=4c8f7ae86d1e54616bb1d879f75843e03b4b696e;hb=fdf5072507c9670d32f378f0a7dbd24ab7bd6b49;hp=e67efab6a963000cef8042263528dff950904200;hpb=27f1388665067f69d5eb64e0cae6bb5f4250beec;p=platform%2Fframework%2Fnative%2Fappfw.git diff --git a/inc/FSecPkcsAlgorithmIdentifier.h b/inc/FSecPkcsAlgorithmIdentifier.h index e67efab..4c8f7ae 100755 --- a/inc/FSecPkcsAlgorithmIdentifier.h +++ b/inc/FSecPkcsAlgorithmIdentifier.h @@ -38,10 +38,10 @@ namespace Tizen { namespace Security { namespace Pkcs * @since 2.1 * * The %AlgorithmIdentifier class implements the ASN.1 specified %AlgorithmIdentifier, which is used for - * creating the standard %AlgorithmIdentifier object. - * %AlgorithmIdentifier structure consists the OID value of the algorithm along with the parameters of that algorithm. + * creating the standard %AlgorithmIdentifier object. The %AlgorithmIdentifier structure consists of the OID value of the + * algorithm along with the parameters of the algorithm. * - * This is defined in ASN.1 as demonstrated in the following code: + * This is defined in ASN.1 as demonstrated in the following code: * @code * AlgorithmIdentifier { ALGORITHM-IDENTIFIER:InfoObjectSet } * ::= @@ -74,45 +74,47 @@ public: virtual ~AlgorithmIdentifier(void); /** - * Initializes the %AlgorithmIdentifier with supplied input parameter values. + * Initializes the %AlgorithmIdentifier with the specified input parameter values. * * @since 2.1 * * @return An error code * @param[in] objectId The object identifier of a particular algorithm @n - * Object IDs are defined by standard bodies for algorithms and other crypto objects. - * Object ID of %AlgorithmIdentifier can be described in string format like 1.2.3.4 + * The object IDs are defined by standard bodies for algorithms and other crypto objects. @n + * The object ID of %AlgorithmIdentifier can be described in string format like 1.2.3.4 * @param[in] pParams A pointer to the AlgorithmParameters object @n - * This is an optional parameter and contains a list of user specified input parameters for the specified algorithm. For example, for Symmetric algorithms Initial vector, IV is required as an input. The default value of this parameter is @c null. - * @exception E_SUCCESS The method is successful. + * This is an optional parameter and contains a list of user specified input parameters for + * the specified algorithm. For example, for Symmetric algorithms Initial vector, IV is required + * as an input. The default value of this parameter is @c null. + * @exception E_SUCCESS The method is successful. * @exception E_INVALID_ARG The specified input parameter is invalid. * @exception E_UNSUPPORTED_ALGORITHM The object ID of the input algorithm is not supported. */ result Construct(const Tizen::Base::String& objectId, const IAlgorithmParameters* pParams = null); /** - * Initializes this instance of %AlgorithmIdentifier with the DER encoded Tizen::Base::ByteBuffer that contains @n + * Initializes this instance of %AlgorithmIdentifier with the DER encoded Tizen::Base::ByteBuffer that contains * the ASN.1 specified %AlgorithmIdentifier structure. * * @since 2.1 * * @return An error code - * @param[in] encodedData An instance of DER encoded Tizen::Base::ByteBuffer - * @exception E_SUCCESS The method is successful. - * @exception E_INVALID_ARG The specified input parameter is invalid. + * @param[in] encodedData An instance of DER encoded Tizen::Base::ByteBuffer + * @exception E_SUCCESS The method is successful. + * @exception E_INVALID_ARG The specified input parameter is invalid. */ result Construct(const Tizen::Base::ByteBuffer& encodedData); /** * Checks whether the specified instance of %AlgorithmIdentifier equals the current instance. * - * @since 2.1 + * @since 2.1 * * @return @c true if the specified instance equals the current instance, @n - * else @c false - * @param[in] rhs An instance of %AlgorithmIdentifier - * @exception E_SUCCESS The method is successful. - * @exception E_INVALID_ARG The specified input parameter is invalid. + * else @c false + * @param[in] rhs An instance of %AlgorithmIdentifier + * @exception E_SUCCESS The method is successful. + * @exception E_INVALID_ARG The specified input parameter is invalid. * @remarks The specific error code can be accessed using the GetLastResult() method. */ virtual bool Equals(const Tizen::Base::Object& rhs) const; @@ -127,12 +129,12 @@ public: virtual int GetHashCode(void) const; /** - * Gets the copy of %AlgorithmIdentifier instance. + * Gets the copy of the %AlgorithmIdentifier instance. * * @since 2.1 * - * @return Pointer to %AlgorithmIdentifier, containing the copy of the specified instance, @n - * else @c null if an error occurs + * @return A pointer to the %AlgorithmIdentifier instance that is the copy of the specified instance, @n + * else @c null if an error occurs * @remarks The specific error code can be accessed using the GetLastResult() method. */ AlgorithmIdentifier* CloneN(void) const; @@ -142,8 +144,8 @@ public: * * @since 2.1 * - * @return Pointer to IAlgorithmParameters, containing the parameter list of algorithm, @n - * else @c null if an no parameters exist + * @return A pointer to the IAlgorithmParameters instance containing the parameter list of algorithm, @n + * else @c null if no parameters exist * @remarks The specific error code can be accessed using the GetLastResult() method. */ IAlgorithmParameters* GetParametersN(void) const; @@ -151,9 +153,9 @@ public: /** * Gets the object ID value of an algorithm in string format. * - * @since 2.1 + * @since 2.1 * - * @return Object ID of %AlgorithmIdentifier in string format like 1.2.3.4 + * @return The object ID of %AlgorithmIdentifier in string format like 1.2.3.4 * */ Tizen::Base::String GetAlgorithmObjectId(void) const; @@ -164,8 +166,8 @@ public: * * @since 2.1 * - * @return Pointer to the DER encoded Tizen::Base::ByteBuffer, @n - * else @c null if an error occurs + * @return A pointer to the DER encoded Tizen::Base::ByteBuffer, @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.