--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/realtimenetprots/sipfw/SIP/sipapi/api/siphttpdigestchallengeobserver2.h	Tue Feb 02 01:03:15 2010 +0200
@@ -0,0 +1,81 @@
+/*
+* 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 "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.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 <e32std.h>
+
+// 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