2 // Open Service Platform
3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
19 * @file FWebCtrlAuthenticationChallenge.h
20 * @brief This is the header file for the %AuthenticationChallenge class.
22 * This header file contains the declarations of the %AuthenticationChallenge class.
25 #ifndef _FWEB_CTRL_AUTHENTICATION_CHALLENGE_H_
26 #define _FWEB_CTRL_AUTHENTICATION_CHALLENGE_H_
28 #include <FBaseDataType.h>
29 #include <FBaseObject.h>
30 #include <FBaseString.h>
32 namespace Tizen { namespace Web { namespace Controls
37 * @class AuthenticationChallenge
38 * @brief This class handles the HyperText Transfer Protocol (HTTP) authentication requests.
42 * The %AuthenticationChallenge class sends the user ID and password to the server requesting user authentication.
44 * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/web/controls_namespace.htm">Web Controls Guide</a>.
46 class _OSP_EXPORT_ AuthenticationChallenge
47 : public Tizen::Base::Object
51 * This destructor overrides Tizen::Base::Object::~Object().
55 virtual ~AuthenticationChallenge(void);
58 * Sends the user ID and password to the host.
63 * @privilege %http://tizen.org/privilege/web.service
65 * @param[in] userId The user ID for authentication
66 * @param[in] password The password for authentication
67 * @exception E_SUCCESS The method is successful.
68 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
69 * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
70 * @remarks The specific error code can be accessed using the GetLastResult() method.
72 void Process(const UserId& userId, const Tizen::Base::String& password);
75 * Cancels the authentication request.
80 * @privilege %http://tizen.org/privilege/web.service
82 * @exception E_SUCCESS The method is successful.
83 * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
84 * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
85 * @remarks The specific error code can be accessed using the GetLastResult() method.
91 // This is the constructor for the %AuthenticationChallenge class.
93 // @remarks This constructor is hidden.
95 AuthenticationChallenge(void);
98 friend class _WebImpl;
99 friend class _AuthenticationChallengeImpl;
100 class _AuthenticationChallengeImpl* __pAuthenticationChallengeImpl;
101 }; // AuthenticationChallenge
103 }}} // Tizen::Web::Controls
104 #endif // _FWEB_CTRL_AUTHENTICATION_CHALLENGE_H_