C H A P T E R 1

About Network Setup

entity, it creates a resource containing the preference data with the resource type matching the preference type and the resource ID the same as the 'cnam' resource.

Network Setup uses a number of private preferences to ensure a reliable round trip conversion between legacy preferences files and the database. The preference types are described in “Common Preference Types” (page 106), but your application should not depend on their presence, their content, or their semantics.

If you find undocumented preferences (such as a preference of type 'vers') in a global protocol entity, do not be concerned. Network Setup itself does not actually look at the data as it imports from and exports to legacy preferences files.

Network Setup Version History

Table 1-1 summarizes the different versions of Network Setup, their features, and their release vehicles.

Table 1-1Network Setup versions

Version

Mac OS version

New features

1.0Mac OS 8.5

1.0.1

Not released

OTCfgGetAreaName

1.0.2

Mac OS 8.6

OTCfgInstallNotifier,

 

 

OTCfgRemoveNotifier

1.1

Not released

OTCfgEncrypt,

 

 

OTCfgDecrypt

1.1.1Mac OS 9.0

There is no easy way to determine the version of Network Setup installed on a system. The best way to test for the presence of a specific Network Setup API enhancement is to weak link to its symbol, as described in TN 1083, “Weak Linking to a Code Fragment Manager-based Shared Library.”

Network Setup Version History

23

Page 23
Image 23
Apple manual Network Setup Version History, Mac OS Not released