mac_pref_cf.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:5k
源码类别:

Symbian

开发平台:

Visual C++

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