mac_pref_cf.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:5k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #pragma once
  36. #ifndef _CARBON
  37. #ifndef _MAC_UNIX
  38. #error use mac_pref.h instead for non-carbon builds
  39. #endif
  40. #endif
  41. #include "pref.h"
  42. #include "cfwrappers.h"
  43. #include "hxstring.h"
  44. #include "mac_pref_file.h"
  45. #include "carray.h"
  46. class CMacPref : public CPref 
  47. {
  48. public:
  49. /*  call open_pref() to automatically create the correct Mac specific preference object. */
  50. /* This will put the product prefs into RealPlayer's prefs file; to create a separate prefs file,
  51.         precede the product name with !, like "!RealProducer". */
  52. static CMacPref *open_pref (const char* pCompanyName, const char* pProductName, int nProdMajorVer, int nProdMinorVer, BOOL bCommon = TRUE);
  53. /*  class destructor - writes prefs to disk. */
  54. virtual ~CMacPref  (void);
  55. /*  read_pref reads the preference specified by Key to the Buffer. */
  56.      HX_RESULT read_pref   (const char* pPrefKey, IHXBuffer*& pBuffer);   
  57.                                                                         
  58. /*  write_pref writes (to memory) the preference specified by Key from the Buffer. */                                                                             
  59.      HX_RESULT    write_pref      (const char* pPrefKey, IHXBuffer* pBuffer); 
  60. /*  delete_pref deletes the preference specified by Key from the Buffer. */                                                                             
  61.      HX_RESULT    delete_pref      (const char* pPrefKey); 
  62. HX_RESULT last_error (void) { return mLastError; } // GR 3/12/02 do we need this here?
  63.     virtual HX_RESULT   remove_pref(const char* pPrefKey);
  64.     virtual HX_RESULT   remove_indexed_pref(const char* pPrefKey);
  65.     HX_RESULT BeginSubPref(const char* szSubPref);
  66.     HX_RESULT EndSubPref();
  67.     HX_RESULT GetPrefKey(UINT32 nIndex,IHXBuffer*& pBuffer);
  68.    
  69. HX_RESULT commit_prefs();
  70. private:
  71. // Constructor NOTE: use open_pref() to create an instance of this class
  72. CMacPref(const char* pCompanyName, const char* pProductName, int nProdMajorVer, int nProdMinorVer, BOOL bCommon); // ctor
  73. /*
  74. CFStringRef m_UserNameRef; // is kCFPreferencesAnyUser or kCFPreferencesCurrentUser depending on bCommon
  75. CFStringRef m_HostNameRef; // is kCFPreferencesCurrentHost or kCFPreferencesAnyHost depending on bCommon
  76. CHXCFString  m_cfsPrefsBundleName;
  77. */
  78. CMacPrefFile* m_pPrefFile;
  79. CHXString m_strProductNamePrefix; // product name becomes the beginning of each pref prefix, like RealMediaSDK or similar
  80. CHXString  m_strSubPrefPrefix;     // empty or "SubPref" or "Sub1Sub2", etc
  81. CHXPtrArray m_arrSubKeyStack; // when we're in nested BeginSubPrefs, stores previous CHXStrings with the prefixes
  82.     HX_RESULT GetPrefKeyInternal(UINT32 nIndex,BOOL bReturnDeeperNestings,CHXString& outStrKey);
  83.     void RemoveSinglePrefInternal(const char* pPrefKey);
  84.    
  85. void MakePrefKeyCF(const char *pPrefKey, CHXCFString& outCfsRealKey);
  86. void MakePrefKey(const char *pPrefKey, CHXString& outMadeKey);
  87. HX_RESULT MakeIHXBuffer(const char *pData, IHXBuffer*& pBuffer);
  88. void EndAllSubPrefs();
  89.  };