--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerpluginsandutils/httpprotocolplugins/wspinc/MWspHeaderCodePages.h Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,104 @@
+// Copyright (c) 2001-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:
+//
+
+/**
+ @file MWspHeaderCodePages.h
+ @warning : This file contains Rose Model ID comments - please do not delete
+*/
+
+#ifndef __MWSPHEADERCODEPAGES_H__
+#define __MWSPHEADERCODEPAGES_H__
+
+// System includes
+#include <e32base.h>
+#include <wsp/wsptypes.h>
+
+class MWspHeaderCodePages
+/**
+@class MWspHeaderCodePages
+@since 7.0
+The MWspHeaderCodePages API provides an interface to a set of header code
+pages as defined by the WSP Specification, July 2001. This capability
+associates a page number with a page name. The Server can negotiate the
+use of header code page proposed by the Client by including the page codes
+(without the page name) in the return negotiation.
+
+The interface allows the set of header code pages to be accessed one by one.
+The read function provides the caller with a copy of the header code page
+information. The set can be reset to the default value of the capability (as
+defined by the WSP Specification), which is an empty set. A header code page
+can be added to the set.
+@publishedAll
+@deprecated
+*/
+ {
+public: // Methods
+
+/**
+ @fn Start() const =0
+ Intended Usage : Ensures that the first header code page in the set is
+ available for reading.
+ @since 7.0
+ @return An error code. If there are no header code pages, then the
+ value returned is KErrNotFound. If there are header code
+ pages then the value KErrNone is returned.
+ @post The subsequent call to GetNext() is applied to the first
+ header code page in the set.
+ */
+ virtual TInt Start() const =0;
+
+/**
+ @fn GetNext(TUint8& aPageCode, TPtrC8& aPageName) const =0
+ Intended Usage : Gets the next header code page in the set. If there are
+ no code pages left then KErrNotFound error code is
+ returned.
+ @since 7.0
+ @param aPageCode A output parameter reference for a byte with the
+ extension code page number.
+ @param aPageName A output parameter reference for a buffer with
+ the name of the header code page.
+ @return An error code. If there are no header code pages left, then
+ the value returned is KErrNotFound. If there are header code
+ pages left then the value KErrNone is returned.
+ @post The next header code page in the set is available for reading.
+ */
+ virtual TInt GetNext(TUint8& aPageCode, TPtrC8& aPageName) const =0;
+
+/**
+ @fn Reset() =0
+ Intended Usage : Resets the capability to the default. The default is
+ defined in the WSP Specification, July 2001, as being an
+ empty set of code pages.
+ @since 7.0
+ @post The set of header code pages is empty.
+ */
+ virtual void Reset() =0;
+
+/**
+ @fn AddHeaderCodePageL(TUint8 aPageCode, const TDesC8& aPageName) =0
+ Intended Usage : Adds a header code page to the set.
+ @since 7.0
+ @leave Leave code KErrNoMemory if the code page cannot be added to
+ the set.
+ @param aPageCode A byte with the extension code page number.
+ @param aPageName A buffer with the name of the header code page.
+ @post If no error has occured then the header code page has been
+ added.
+ */
+ virtual void AddHeaderCodePageL(TUint8 aPageCode, const TDesC8& aPageName) =0;
+
+ };
+
+#endif // __MWSPHEADERCODEPAGES_H__