/**
* @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
*
* @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.
*/
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;
* @since 2.0
*
* @return An error code
- * @param[in] certificateType The type of the Certificate (that is, ROOT_CA, OPERATOR_DOMAIN, or TRUSTED_THIRD_PARTY_DOMAIN)
+ * @param[in] certificateType The type of the Certificate (that is, @c ROOT_CA, @c OPERATOR_DOMAIN, or @c TRUSTED_THIRD_PARTY_DOMAIN)
* @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;
* @since 2.0
*
* @return An error code
- * @param[in] certificateType The type of the Certificate (that is, ROOT_CA, OPERATOR_DOMAIN, or TRUSTED_THIRD_PARTY_DOMAIN)
+ * @param[in] certificateType The type of the Certificate (that is, @c ROOT_CA, @c OPERATOR_DOMAIN, or @c TRUSTED_THIRD_PARTY_DOMAIN)
* @param[in] oldCert A reference to the old certificate
* @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;
* @since 2.0
*
* @return An error code
- * @param[in] certificateType The type of the Certificate (that is, ROOT_CA, OPERATOR_DOMAIN, or TRUSTED_THIRD_PARTY_DOMAIN)
+ * @param[in] certificateType The type of the Certificate (that is, @c ROOT_CA, @c OPERATOR_DOMAIN, or @c TRUSTED_THIRD_PARTY_DOMAIN)
* @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;