CFPreferencesSetValue

Header: CFPreferences.h Carbon status: Supported

Adds, modifies, or removes a preference value for the specified domain.

void CFPreferencesSetValue (
    CFStringRef key, 
    CFPropertyListRef value, 
    CFStringRef appName, 
    CFStringRef user, 
    CFStringRef host
);
Parameter descriptions
key

Preferences key for the value you wish to set.

value

The value you wish to set for the specified key and application. Pass NULL to remove the specified key from the domain.

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.

DISCUSSION

This function is the primitive set mechanism for the higher level preference function CFPreferencesSetAppValue. Only the exact domain specified is modified. Do not use this function directly unless you have a specific need. All arguments except value.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)