Enable build with iniparser v 3.1
[platform/framework/native/appfw.git] / inc / FSecCertICertificateStore.h
index 897ffe0..e964ec4 100644 (file)
@@ -36,7 +36,7 @@ namespace Tizen { namespace Security { namespace Cert
 
 /**
  *     @interface      ICertificateStore
- *     @brief          This is the interface for retrieving and managing the certificates from a repository.
+ *     @brief          This interface provides methods for retrieving and managing the certificates from a repository.
  *
  *     @since          2.0
  *
@@ -71,11 +71,12 @@ public:
         *      @since          2.0
         *
         *      @return         An error code
-        *      @param[in]      selector                                A selector that defines a set of criterion for selecting certificates
+        *      @param[in]      selector                                The selector that defines a set of criterion for selecting certificates
         *      @exception      E_SUCCESS                               The method is successful.
         *      @exception      E_OUT_OF_MEMORY                 The memory is insufficient.
-        *      @exception      E_SYSTEM                                A system error has occurred. @n
-        *                                                                              The IPC operation has failed.
+        *      @exception      E_SYSTEM                                Either of the following conditions has occurred:
+        *                                                                              - A system error has occurred.
+        *                                                                              - The IPC operation has failed.
         *      @exception      E_INVALID_ARG                   The specified @c selector is invalid.
         *      @exception      E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
         */
@@ -94,18 +95,19 @@ public:
        virtual result GetCertificateCount(int& count) const = 0;
 
        /**
-        *      Gets each certificate that matches the specified selector.
+        *      Gets the certificate that matches the specified selector.
         *
         *      @since          2.0
         *
-        *      @return         The certificates that match the specified selector
+        *      @return         The certificate that matches the specified selector
         *      @exception      E_SUCCESS                               The method is successful.
         *      @exception      E_OUT_OF_MEMORY                 The memory is insufficient.
         *      @exception      E_OBJ_NOT_FOUND                 The certificate is not found.
-        *      @exception      E_SYSTEM                                A system error has occurred. @n
-        *                                                                              The Tizen::Base::ByteBuffer operation has failed.
+        *      @exception      E_SYSTEM                                Either of the following conditions has occurred:
+        *                                                                              - A system error has occurred.
+        *                                                                              - The Tizen::Base::ByteBuffer operation has failed.
         *      @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.
+        *  @remarks    The specific error code can be accessed using the GetLastResult() method.
         */
        virtual Tizen::Security::Cert::ICertificate* GetNextCertificateN(void) const = 0;
 
@@ -119,10 +121,12 @@ public:
         *      @param[in]      certificate                             A reference to the certificate to insert
         *      @exception      E_SUCCESS                               The method is successful.
         *      @exception      E_OUT_OF_MEMORY                 The memory is insufficient.
-        *      @exception      E_INVALID_ARG                   The specified @c certificate or the certificate data is invalid, or
-        *                                                                              the specified @c certificateType is invalid.
-        *      @exception      E_SYSTEM                                A system error has occurred. @n
-        *                                      Either the IPC operation or the file operation or the DB operation has failed.
+        *      @exception      E_INVALID_ARG                   Either of the following conditions has occurred:
+        *                                                                              - The specified @c certificate or the certificate data is invalid.
+        *                                                                              - The specified @c certificateType is invalid.
+        *      @exception      E_SYSTEM                                Either of the following conditions has occurred:
+        *                                                                              - A system error has occurred.
+        *                                                                              - Either the IPC operation or the file operation or the DB operation has failed.
         *      @exception      E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
         */
        virtual result Insert(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& certificate) = 0;
@@ -138,11 +142,13 @@ public:
         *      @param[in]      newCert                                 A reference to the new certificate
         *      @exception      E_SUCCESS                               The method is successful.
         *      @exception      E_OUT_OF_MEMORY                 The memory is insufficient.
-        *      @exception      E_INVALID_ARG                   The specified @c certificate or the certificate data is invalid, or
-        *                                                                                      the specified @c certificateType is invalid.
+        *      @exception      E_INVALID_ARG                   Either of the following conditions has occurred:
+        *                                                                              - The specified @c certificate or the certificate data is invalid.
+        *                                                                              - The specified @c certificateType is invalid.
         *      @exception      E_OBJ_NOT_FOUND                 The certificate is not found.
-        *      @exception      E_SYSTEM                                A system error has occurred. @n
-        *                                      Either the IPC operation or the file operation or the DB operation has failed.
+        *      @exception      E_SYSTEM                                Either of the following conditions has occurred:
+        *                                                                              - A system error has occurred.
+        *                                                                              - Either the IPC operation or the file operation or the DB operation has failed.
         *      @exception      E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
         */
        virtual result Update(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& oldCert, const Tizen::Security::Cert::ICertificate& newCert) = 0;
@@ -157,11 +163,13 @@ public:
         *      @param[in]      certificate                             A reference to the certificate to remove
         *      @exception      E_SUCCESS                               The method is successful.
         *      @exception      E_OUT_OF_MEMORY                 The memory is insufficient.
-        *      @exception      E_INVALID_ARG                   The specified @c certificate or the certificate data is invalid, or
-        *                                                                                      the specified @c certificateType is invalid.
+        *      @exception      E_INVALID_ARG                   Either of the following conditions has occurred:
+        *                                                                              - The specified @c certificate or the certificate data is invalid.
+        *                                                                              - The specified @c certificateType is invalid.
         *      @exception      E_OBJ_NOT_FOUND                 The certificate is not found.
-        *      @exception      E_SYSTEM                                A system error has occurred. @n
-        *                                      Either the IPC operation or the file operation or the DB operation has failed.
+        *      @exception      E_SYSTEM                                Either of the following conditions has occurred:
+        *                                                                              - A system error has occurred.
+        *                                                                              - Either the IPC operation or the file operation or the DB operation has failed.
         *      @exception      E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
         */
        virtual result Remove(CertificateType certificateType, const Tizen::Security::Cert::ICertificate& certificate) = 0;