diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/siphttpdigestchallengeobserver2.h --- a/epoc32/include/siphttpdigestchallengeobserver2.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/siphttpdigestchallengeobserver2.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,81 @@ -siphttpdigestchallengeobserver2.h +/* +* Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* Name : siphttpdigestchallengeobserver2.h +* Part of : SIP Client +* Interface : SDK API, SIP Client API +* Version : 1.0 +* +*/ + + + +#ifndef MSIPHTTPDIGESTCHALLENGEOBSERVER2_H +#define MSIPHTTPDIGESTCHALLENGEOBSERVER2_H + +// INCLUDES +#include + +// FORWARD DECLARATIONS +class CSIPClientTransaction; +class CSIPRefresh; + +// CLASS DECLARATION +/** +* @publishedAll +* @released +* +* The user should implement this interface if it intends to +* provide HTTP Digest credentials upon received challenges +* from the SIP servers on the signaling path. +* The user should provide credentials or ignore the challenge +* using functions defined in CSIPHttpDigest class. +* +* @lib n/a +*/ +class MSIPHttpDigestChallengeObserver2 + { + public: // New functions + /** + * A SIP request resulted in 401/407 response that contains + * 1..n challenges. + * The challenges can be obtained from Proxy-Authenticate- and/or + * WWW-Authenticate-headers in the CSIPResponseElements + * attached to the CSIPClientTransaction. + * The user must call CSIPHttpDigest::SetCredentialsL or + * CSIPHttpDigest::IgnoreChallenge for each challenge. + * + * @param aTransaction transaction which was completed with + * a response containing HTTP Digest challenge. + */ + virtual void ChallengeReceived( + const CSIPClientTransaction& aTransaction) = 0; + + /** + * A refreshed SIP request resulted in 401/407 response that contains + * 1..n challenges. + * The challenges can be obtained from Proxy-Authenticate- and/or + * WWW-Authenticate-headers in the CSIPResponseElements + * attached to the CSIPClientTransaction attached to the CSIPRefresh. + * The user must call CSIPHttpDigest::SetCredentialsL or + * CSIPHttpDigest::IgnoreChallenge for each challenge. + * + * @param aRefresh the refresh for which a transaction completed with + * a response containing HTTP Digest challenge. + */ + virtual void ChallengeReceived( + const CSIPRefresh& aRefresh) = 0; + }; + +#endif // MSIPHTTPDIGESTCHALLENGEOBSERVER2_H