Merge "Update deprecated libprivilege-control API functions." into tizen
[platform/framework/native/appfw.git] / inc / FSecCertICertificateSelector.h
1 //
2 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
3 //
4 // Licensed under the Apache License, Version 2.0 (the License);
5 // you may not use this file except in compliance with the License.
6 // You may obtain a copy of the License at
7 //
8 //     http://www.apache.org/licenses/LICENSE-2.0
9 //
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
15 //
16
17 /**
18  * @file                FSecCertICertificateSelector.h
19  * @brief               This is the header file for the %ICertificateSelector interface.
20  *
21  * This header file contains the declarations of the %ICertificateSelector interface.
22  */
23 #ifndef _FSEC_CERT_ICERTIFICATE_SELECTOR_H_
24 #define _FSEC_CERT_ICERTIFICATE_SELECTOR_H_
25
26 #include <FSecCertICertificate.h>
27
28
29 namespace Tizen { namespace Security { namespace Cert
30 {
31
32 /**
33  *  @interface  ICertificateSelector
34  *  @brief              This interface is a selector that defines a set of criterion for selecting certificates.
35  *
36  *      @since                  2.0
37  *
38  * The %ICertificateSelector interface is a selector that defines a set of criterion for selecting certificates.
39  * The classes that implement this interface are used to specify the certificates, which must be retrieved from a certificate store. @n
40  *
41  * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/security/certificate_namespace.htm">Certificates</a>.
42  *
43  */
44 class _OSP_EXPORT_ ICertificateSelector
45 {
46
47 public:
48         /**
49          *      This is the destructor for this class.
50          *
51          *      @since          2.0
52          */
53         virtual ~ICertificateSelector(void) {}
54
55         /**
56          *      Gets the certificate type.
57          *
58          *      @since          2.0
59          *
60          *      @return         The certificate type
61          */
62         virtual CertificateType GetType(void) const = 0;
63
64         /**
65          * Sets the certificate type.
66          *
67          * @since       2.0
68          *
69          * @param[in]   certificateType         The certificate type
70          */
71         virtual void SetType(CertificateType certificateType) = 0;
72
73 protected:
74         //
75         // This method is for internal use only. Using this method can cause behavioral, security-related,
76         // and consistency-related issues in the application.
77         //
78         // This method is reserved and may change its name at any time without prior notice.
79         //
80         // @since 2.0
81         //
82         virtual void ICertificateSelector_Reserved1(void) {}
83
84         //
85         // This method is for internal use only. Using this method can cause behavioral, security-related,
86         // and consistency-related issues in the application.
87         //
88         // This method is reserved and may change its name at any time without prior notice.
89         //
90         // @since 2.0
91         //
92         virtual void ICertificateSelector_Reserved2(void) {}
93
94         //
95         // This method is for internal use only. Using this method can cause behavioral, security-related,
96         // and consistency-related issues in the application.
97         //
98         // This method is reserved and may change its name at any time without prior notice.
99         //
100         // @since 2.0
101         //
102         virtual void ICertificateSelector_Reserved3(void) {}
103
104 }; // ICertificateSelector
105
106 } } } // Tizen::Security::Cert
107
108 #endif // _FSEC_CERT_ICERTIFICATE_SELECTOR_H_