X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFSecCertICertificateStore.h;h=e964ec43c4c508c8e422184740957401db645f5d;hb=20597a73bc3098301ba91a48378f3ef009c3be96;hp=897ffe0f64d0769c95d29541d337da32e43c6348;hpb=52af7a7653f5c58c84cf9cc16bf92ae25e037462;p=platform%2Fframework%2Fnative%2Fappfw.git

diff --git a/inc/FSecCertICertificateStore.h b/inc/FSecCertICertificateStore.h
index 897ffe0..e964ec4 100644
--- a/inc/FSecCertICertificateStore.h
+++ b/inc/FSecCertICertificateStore.h
@@ -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;