CFPreferencesAddSuitePreferencesToApp

Header: CFPreferences.h Carbon status: Under Evaluation

Adds suite preferences to an application’s preference search chain.

void CFPreferencesAddSuitePreferencesToApp (
    CFStringRef applicationID, 
    CFStringRef suiteName
);
Parameter descriptions
applicationID

The ID of the application to which you wish to add suite preferences, typically kCFPreferencesCurrentApplication. Do not pass NULL or kCFPreferencesAnyApplication.

suiteName

The ID of the application suite preferences you wish to add. SuiteIDs take the form of Java package names, com.foosoft.powersuite , for example

DISCUSSION

Suite preferences allow you to maintain a set of preferences that are common to all applications in the suite. When a suite is added to an application’s search chain, all of the domains pertaining to that suite are inserted into the chain. Suite preferences are added between the “Current Application” domains and the “Any Application” domains. If you add multiple suite preferences to one application, the order of the suites in the search chain is non-deterministic. You can override a suite preference for a given application by defining the same preference key in the application specific preferences.

AVAILABILITY

Under evaluation for Carbon. Available in Carbon 1.1 and later when CarbonLib 1.1CarbonLib 1.1 or later is present.


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