CFPreferences.h
上传用户:xjjlds
上传日期:2015-12-05
资源大小:22823k
文件大小:4k
源码类别:

多媒体编程

开发平台:

Visual C++

  1. /*
  2.      File:       CFPreferences.h
  3.  
  4.      Contains:   CoreFoundation preferences
  5.  
  6.      Version:    Technology: Mac OS X
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1999-2001 by Apple Computer, Inc., all rights reserved
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __CFPREFERENCES__
  18. #define __CFPREFERENCES__
  19. #ifndef __CFBASE__
  20. #include "CFBase.h"
  21. #endif
  22. #ifndef __CFARRAY__
  23. #include "CFArray.h"
  24. #endif
  25. #ifndef __CFDICTIONARY__
  26. #include "CFDictionary.h"
  27. #endif
  28. #ifndef __CFSTRING__
  29. #include "CFString.h"
  30. #endif
  31. #if PRAGMA_ONCE
  32. #pragma once
  33. #endif
  34. #ifdef __cplusplus
  35. extern "C" {
  36. #endif
  37. #if PRAGMA_IMPORT
  38. #pragma import on
  39. #endif
  40. #if PRAGMA_STRUCT_ALIGN
  41.     #pragma options align=mac68k
  42. #elif PRAGMA_STRUCT_PACKPUSH
  43.     #pragma pack(push, 2)
  44. #elif PRAGMA_STRUCT_PACK
  45.     #pragma pack(2)
  46. #endif
  47. extern const CFStringRef kCFPreferencesAnyApplication;
  48. extern const CFStringRef kCFPreferencesAnyHost;
  49. extern const CFStringRef kCFPreferencesCurrentHost;
  50. extern const CFStringRef kCFPreferencesAnyUser;
  51. extern const CFStringRef kCFPreferencesCurrentUser;
  52. /* Searches the various sources of application defaults to find the value for the given key.  
  53.    key must not be NULL.  If a value is found, it returns it; otherwise returns NULL.  Caller 
  54.    must release the returned value */
  55. EXTERN_API_C( CFTypeRef )
  56. CFPreferencesCopyAppValue       (CFStringRef            key,
  57.                                  CFStringRef            appName);
  58. /* Sets the given value for the given key in the "normal" place for application preferences.  
  59.    key must not be NULL.  If value is NULL, key is removed instead. */
  60. EXTERN_API_C( void )
  61. CFPreferencesSetAppValue        (CFStringRef            key,
  62.                                  CFTypeRef              value,
  63.                                  CFStringRef            appName);
  64. /* Writes all changes in all sources of application defaults.  Returns success or failure. */
  65. EXTERN_API_C( Boolean )
  66. CFPreferencesAppSynchronize     (CFStringRef            appName);
  67. /* The primitive get mechanism; all arguments must be non-NULL (use the constants above for common values).  
  68.    Only the exact location specified by app-user-host is searched.  The returned CFType must be released by 
  69.    the caller when it is finished with it. */
  70. EXTERN_API_C( CFTypeRef )
  71. CFPreferencesCopyValue          (CFStringRef            key,
  72.                                  CFStringRef            appName,
  73.                                  CFStringRef            user,
  74.                                  CFStringRef            host);
  75. /* The primitive set function; all arguments except value must be non-NULL.  If value is NULL, the given key is removed */
  76. EXTERN_API_C( void )
  77. CFPreferencesSetValue           (CFStringRef            key,
  78.                                  CFTypeRef              value,
  79.                                  CFStringRef            appName,
  80.                                  CFStringRef            user,
  81.                                  CFStringRef            host);
  82. EXTERN_API_C( Boolean )
  83. CFPreferencesSynchronize        (CFStringRef            appName,
  84.                                  CFStringRef            user,
  85.                                  CFStringRef            host);
  86. /* Constructs and returns the list of the name of all applications which have preferences in the scope of the given user and host.
  87.     The returned value must be released by the caller; neither argument may be NULL. */
  88. EXTERN_API_C( CFArrayRef )
  89. CFPreferencesCopyApplicationList (CFStringRef           userName,
  90.                                  CFStringRef            hostName);
  91. /* Constructs and returns the list of all keys set in the given location.  
  92.    The returned value must be released by the caller; all arguments must be non-NULL */
  93. EXTERN_API_C( CFArrayRef )
  94. CFPreferencesCopyKeyList        (CFStringRef            appName,
  95.                                  CFStringRef            userName,
  96.                                  CFStringRef            hostName);
  97. #if PRAGMA_STRUCT_ALIGN
  98.     #pragma options align=reset
  99. #elif PRAGMA_STRUCT_PACKPUSH
  100.     #pragma pack(pop)
  101. #elif PRAGMA_STRUCT_PACK
  102.     #pragma pack()
  103. #endif
  104. #ifdef PRAGMA_IMPORT_OFF
  105. #pragma import off
  106. #elif PRAGMA_IMPORT
  107. #pragma import reset
  108. #endif
  109. #ifdef __cplusplus
  110. }
  111. #endif
  112. #endif /* __CFPREFERENCES__ */