CFPreferencesSynchronize

Header: CFPreferences.h Carbon status: Supported

Writes all pending changes to preference data for the specified domain.

Boolean CFPreferencesSynchronize (
    CFStringRef appName, 
    CFStringRef user, 
    CFStringRef host
);
Parameter descriptions
appName

The ID of the application whose preferences you wish to modify.

user

The name of the user whose preferences you wish to modify.

host

The name of the host whose preferences you wish to modify.

function result

TRUE if synchronization was successful; FALSE if an error occurred.

DISCUSSION

This function is the primitive synchronize mechanism for the higher level preference function CFPreferencesAppSynchronize. Only the exact domain specified is modified. Do not use this function directly unless you have a specific need. All arguments must be non-NULL Do not use arbitrary user and host names, instead pass the pre-defined constants.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)