CFPreferences.h
上传用户:xjjlds
上传日期:2015-12-05
资源大小:22823k
文件大小:4k
- /*
- File: CFPreferences.h
-
- Contains: CoreFoundation preferences
-
- Version: Technology: Mac OS X
- Release: QuickTime 6.0.2
-
- Copyright: (c) 1999-2001 by Apple Computer, Inc., all rights reserved
-
- Bugs?: For bug reports, consult the following page on
- the World Wide Web:
-
- http://developer.apple.com/bugreporter/
-
- */
- #ifndef __CFPREFERENCES__
- #define __CFPREFERENCES__
- #ifndef __CFBASE__
- #include "CFBase.h"
- #endif
- #ifndef __CFARRAY__
- #include "CFArray.h"
- #endif
- #ifndef __CFDICTIONARY__
- #include "CFDictionary.h"
- #endif
- #ifndef __CFSTRING__
- #include "CFString.h"
- #endif
- #if PRAGMA_ONCE
- #pragma once
- #endif
- #ifdef __cplusplus
- extern "C" {
- #endif
- #if PRAGMA_IMPORT
- #pragma import on
- #endif
- #if PRAGMA_STRUCT_ALIGN
- #pragma options align=mac68k
- #elif PRAGMA_STRUCT_PACKPUSH
- #pragma pack(push, 2)
- #elif PRAGMA_STRUCT_PACK
- #pragma pack(2)
- #endif
- extern const CFStringRef kCFPreferencesAnyApplication;
- extern const CFStringRef kCFPreferencesAnyHost;
- extern const CFStringRef kCFPreferencesCurrentHost;
- extern const CFStringRef kCFPreferencesAnyUser;
- extern const CFStringRef kCFPreferencesCurrentUser;
- /* Searches the various sources of application defaults to find the value for the given key.
- key must not be NULL. If a value is found, it returns it; otherwise returns NULL. Caller
- must release the returned value */
- EXTERN_API_C( CFTypeRef )
- CFPreferencesCopyAppValue (CFStringRef key,
- CFStringRef appName);
- /* Sets the given value for the given key in the "normal" place for application preferences.
- key must not be NULL. If value is NULL, key is removed instead. */
- EXTERN_API_C( void )
- CFPreferencesSetAppValue (CFStringRef key,
- CFTypeRef value,
- CFStringRef appName);
- /* Writes all changes in all sources of application defaults. Returns success or failure. */
- EXTERN_API_C( Boolean )
- CFPreferencesAppSynchronize (CFStringRef appName);
- /* The primitive get mechanism; all arguments must be non-NULL (use the constants above for common values).
- Only the exact location specified by app-user-host is searched. The returned CFType must be released by
- the caller when it is finished with it. */
- EXTERN_API_C( CFTypeRef )
- CFPreferencesCopyValue (CFStringRef key,
- CFStringRef appName,
- CFStringRef user,
- CFStringRef host);
- /* The primitive set function; all arguments except value must be non-NULL. If value is NULL, the given key is removed */
- EXTERN_API_C( void )
- CFPreferencesSetValue (CFStringRef key,
- CFTypeRef value,
- CFStringRef appName,
- CFStringRef user,
- CFStringRef host);
- EXTERN_API_C( Boolean )
- CFPreferencesSynchronize (CFStringRef appName,
- CFStringRef user,
- CFStringRef host);
- /* Constructs and returns the list of the name of all applications which have preferences in the scope of the given user and host.
- The returned value must be released by the caller; neither argument may be NULL. */
- EXTERN_API_C( CFArrayRef )
- CFPreferencesCopyApplicationList (CFStringRef userName,
- CFStringRef hostName);
- /* Constructs and returns the list of all keys set in the given location.
- The returned value must be released by the caller; all arguments must be non-NULL */
- EXTERN_API_C( CFArrayRef )
- CFPreferencesCopyKeyList (CFStringRef appName,
- CFStringRef userName,
- CFStringRef hostName);
- #if PRAGMA_STRUCT_ALIGN
- #pragma options align=reset
- #elif PRAGMA_STRUCT_PACKPUSH
- #pragma pack(pop)
- #elif PRAGMA_STRUCT_PACK
- #pragma pack()
- #endif
- #ifdef PRAGMA_IMPORT_OFF
- #pragma import off
- #elif PRAGMA_IMPORT
- #pragma import reset
- #endif
- #ifdef __cplusplus
- }
- #endif
- #endif /* __CFPREFERENCES__ */