diff --git a/src/widgets/sslui.h b/src/widgets/sslui.h index 1d239e4e..8a323c2d 100644 --- a/src/widgets/sslui.h +++ b/src/widgets/sslui.h @@ -1,59 +1,65 @@ /* This file is part of the KDE project * * Copyright (C) 2009 Andreas Hartmetz * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB. If not, write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. */ #ifndef _KSSLUI_H #define _KSSLUI_H #include "kiowidgets_export.h" -#include +#include +#include // TODO KF6 remove this include namespace KIO { +/** UI methods for handling SSL errors. */ namespace SslUi { +/** Error rule storage behavior. */ enum RulesStorage { RecallRules = 1, ///< apply stored certificate rules (typically ignored errors) StoreRules = 2, ///< make new ignore rules from the user's choice and store them RecallAndStoreRules = 3 ///< apply stored rules and store new rules }; -bool KIOWIDGETS_EXPORT askIgnoreSslErrors(const KTcpSocket *socket, - RulesStorage storedRules = RecallAndStoreRules); +/** + * @deprecated since 5.64 use the KSslErrorUiData variant instead. + */ +bool KIOWIDGETS_DEPRECATED_EXPORT askIgnoreSslErrors(const KTcpSocket *socket, + RulesStorage storedRules = RecallAndStoreRules); // TODO KF6 remove /** * If there are errors while establishing an SSL encrypted connection to a peer, usually due to * certificate issues, and since this poses a security issue, we need confirmation from the user about * how they wish to proceed. * * This function provides a dialog asking the user if they wish to abort the connection or ignore * the SSL errors that occurred and continue connecting. And in case of the latter whether to remember * the decision in the future or ignore the error temporarily. * * @p uiData the KSslErrorUiData object constructed from the socket that is trying to establish the * encrypted connection * @p storedRules see RulesStorage Enum */ bool KIOWIDGETS_EXPORT askIgnoreSslErrors(const KSslErrorUiData &uiData, RulesStorage storedRules = RecallAndStoreRules); } } #endif