Apple Network Setup - Manual (Page 71)

C H A P T E R 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.
◆