Apple Network Setup - Manual (Page 70)

C H A P T E R 3
Network Setup Reference
70 Network Setup Functions
OTCfgCreateArea 3
Creates an area in the Network Setup database.
OSStatus OTCfgCreateArea (CfgDatabaseRef dbRef,
ConstStr255Param areaName,
CfgAreaID* areaID);
dbRef On input, a value of type CfgDatabaseRef (page 98) that
represents a database session previously opened by calling
OTCfgOpenDatabase (page 58).
areaName On input, a value of type ConstStr255Param that specifies the
user-visible name of the area to create. If an area of the name
specified by
areaName already exists, OTCfgCreateArea returns
kCfgErrAreaAlreadyExists .
areaID On input, a pointer to a value of type CfgAreaID (page 98). On
output, areaID contains the ID of the area that was created.
function result A value of noErr indicates that OTCfgCreateArea returned
successfully. For a list of other possible result codes, see “Result
Codes” (page 110).
DISCUSSION
The OTCfgCreateArea function creates an area of the specified name in the
database.
IMPORTANT
The OTCfgCreateArea function has almost no purpose in the
version of Network Setup described by this document. ◆