//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
//
/**
- * @if VISPARTNER
* @file FSecCertICertificateStore.h
* @brief This is the header file for the %ICertificateStore interface.
*
* This header file contains the declarations of the %ICertificateStore interface.
*
- * @endif
*/
#ifndef _FSEC_CERT_ICERTIFICATE_STORE_H_
#define _FSEC_CERT_ICERTIFICATE_STORE_H_
{
/**
- * @if VISPARTNER
* @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
- *
- * @visibility partner
+ * @since 2.0
*
* The %ICertificateStore interface is used for retrieving and managing the certificates from a repository.
- * @endif
*/
class _OSP_EXPORT_ ICertificateStore
{
* @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;
projects / platform / framework / native / appfw.git / blobdiff