Function

CFPreferencesAppSynchronize(_:)

Writes to permanent storage all pending changes to the preference data for the application, and reads the latest preference data from permanent storage.

Declaration

func CFPreferencesAppSynchronize(_ applicationID: CFString) -> Bool

Parameters

applicationID

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

Return Value

true if synchronization was successful, otherwise false.

Discussion

Calling the function CFPreferencesSetAppValue(_:_:_:) is not in itself sufficient for storing preferences. The CFPreferencesAppSynchronize(_:) function writes to permanent storage all pending preference changes for the application. Typically you would call this function after multiple calls to CFPreferencesSetAppValue(_:_:_:). Conversely, preference data is cached after it is first read. Changes made externally are not automatically incorporated. The CFPreferencesAppSynchronize(_:) function reads the latest preferences from permanent storage.

See Also

Synchronizing Preferences

func CFPreferencesSynchronize(CFString, CFString, CFString) -> Bool

For the specified domain, writes all pending changes to preference data to permanent storage, and reads latest preference data from permanent storage.

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