Apple Network Setup Network Card User Manual


 
CHAPTER 3
Network Setup Reference
Network Setup Functions 71
OTCfgDuplicateArea 3
Copies the contents of one area to another area.
OSStatus OTCfgDuplicateArea (CfgDatabaseRef dbRef,
CfgAreaID sourceAreaID,
CfgAreaID destAreaID);
dbRef
On input, a value of type CfgDatabaseRef (page 98) that
represents a database session previously opened by calling
OTCfgOpenDatabase (page 58).
sourceAreaID On input, a value of type CfgAreaID (page 98) that identifies the
area that is to be duplicated. If the area specified by areaID does
not exist, OTCfgDuplicateArea returns kCfgErrAreaNotFound.
destAreaID On input, a value of type CfgAreaID (page 98) that identifies the
area that is to contain the duplicated area. If the area specified
by areaID does not exist, OTCfgDuplicateArea returns
kCfgErrAreaNotFound.
function result A value of noErr indicates that OTCfgDuplicateArea returned
successfully. For a list of other possible result codes, see “Result
Codes” (page 110).
DISCUSSION
The OTCfgDuplicateArea function copies the contents of the area specified by
sourceAreaID into the area specified by destAreaID. Both areas must exist before
you call OTCfgDuplicateArea. To create an area, call OTCfgCreateArea (page 70).
IMPORTANT
The OTCfgDuplicateArea function has almost no purpose in
the version of Network Setup described by this
document.