Apple Network Setup - Manual (Page 61)

C H A P T E R 3
Network Setup Reference
Network Setup Functions 61
OTCfgSetCurrentArea 3
Sets the default area.
OSStatus OTCfgSetCurrentArea (CfgDatabaseRef dbRef,
CfgAreaID areaID);
dbRef On input, a value of type CfgDatabaseRef (page 98) that
represents a database session previously opened by calling
OTCfgOpenDatabase (page 58).
areaID On input, a value of type CfgAreaID (page 98) containing the
areaID that identifies the area that is to be made active. If the
area does not exist, OTCfgSetCurrentArea returns
kCfgErrAreaNotFound .
function result A value of noErr indicates that OTCfgSetCurrentArea returned
successfully. For a list of other possible result codes, see “Result
Codes” (page 110).
DISCUSSION
The OTCfgSetCurrentArea function makes the area ID specified by the areaID
parameter the default area. The default area is sometimes referred to as the
current area.
▲
W AR N I N G
Do not change the default area. If you want to modify
settings, make changes to the entities within the default
area.
▲
OTCfgOpenArea 3
Opens an area in the Network Setup database for reading.
OSStatus OTCfgOpenArea (CfgDatabaseRef dbRef,
CfgAreaID areaID);