2 * Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
4 * This component and the accompanying materials are made available
5 * under the terms of "Eclipse Public License v1.0"
6 * which accompanies this distribution, and is available
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
9 * Initial Contributors:
10 * Nokia Corporation - initial contribution.
15 * Name : sipproxyrequireheader.h
17 * Interface : SDK API, SIP Codec API
25 #ifndef CSIPPROXYREQUIREHEADER_H
26 #define CSIPPROXYREQUIREHEADER_H
29 #include "siptokenheaderbase.h"
36 * Class provides functions for setting and getting parameters in
37 * SIP "Proxy-Require" header.
41 class CSIPProxyRequireHeader : public CSIPTokenHeaderBase
43 public: // Constructors and destructor
46 * Constructs a CSIPProxyRequireHeader from textual representation
47 * of the header's value part.
48 * @param aValue a value part of a "Proxy-Require"-header
49 * @return an array containing 1..n instances of CSIPProxyRequireHeader
51 IMPORT_C static RPointerArray<CSIPProxyRequireHeader>
52 DecodeL(const TDesC8& aValue);
55 * Creates a new instance of CSIPProxyRequireHeader
56 * @param aValue a tag value
57 * @return a new instance of CSIPProxyRequireHeader
59 IMPORT_C static CSIPProxyRequireHeader* NewL(RStringF aValue);
62 * Creates a new instance of CSIPProxyRequireHeader
63 * and puts it to CleanupStack
64 * @param aValue a tag value
65 * @return a new instance of CSIPProxyRequireHeader
67 IMPORT_C static CSIPProxyRequireHeader* NewLC(RStringF aValue);
70 * Destructor, deletes the resources of CSIPProxyRequireHeader.
72 IMPORT_C ~CSIPProxyRequireHeader();
75 public: // New functions
78 * Constructs an instance of a CSIPProxyRequireHeader from a RReadStream
79 * @param aReadStream a stream containing the value of the
80 * externalized object (header name not included).
81 * @return an instance of a CSIPProxyRequireHeader
83 IMPORT_C static CSIPHeaderBase* InternalizeValueL(RReadStream& aReadStream);
86 public: // From CSIPHeaderBase
89 * From CSIPHeaderBase CloneL
91 IMPORT_C CSIPHeaderBase* CloneL() const;
94 * From CSIPHeaderBase Name
96 IMPORT_C RStringF Name() const;
99 public: // From CSIPHeaderBase, For internal use
104 TPreferredPlace PreferredPlaceInMessage() const;
106 public: // New functions, for internal use
108 static RPointerArray<CSIPHeaderBase> BaseDecodeL(const TDesC8& aValue);
110 private: // Constructors
112 CSIPProxyRequireHeader();
113 CSIPProxyRequireHeader(const CSIPProxyRequireHeader& aHeader);
116 #endif // end of CSIPPROXYREQUIREHEADER_H