Function

CFPreferencesCopyAppValue

Obtains a preference value for the specified key and application.

Declaration

CFPropertyListRef CFPreferencesCopyAppValue(CFStringRef key, CFStringRef applicationID);

Parameters

key

The preference key whose value to obtain.

applicationID

The identifier of the application whose preferences to search, typically kCFPreferencesCurrentApplication. Do not pass NULL or kCFPreferencesAnyApplication. Takes the form of a Java package name, com.foosoft.

Return Value

The preference data for the specified key and application. If no value was located, returns NULL. Ownership follows the The Create Rule.

Discussion

Note that values returned from this function are immutable, even if you have recently set the value using a mutable object.

See Also

Getting Preference Values

CFPreferencesCopyKeyList

Constructs and returns the list of all keys set in the specified domain.

CFPreferencesCopyMultiple

Returns a dictionary containing preference values for multiple keys.

CFPreferencesCopyValue

Returns a preference value for a given domain.

CFPreferencesGetAppBooleanValue

Convenience function that directly obtains a Boolean preference value for the specified key.

CFPreferencesGetAppIntegerValue

Convenience function that directly obtains an integer preference value for the specified key.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software