Apple Network Setup - Manual (Page 76)

C H A P T E R 3
Network Setup Reference
76 Network Setup Functions
OTCfgIsSameEntityRef 3
Compares two entity references.
Boolean OTCfgIsSameEntityRef (const CfgEntityRef* entityRef1,
const CfgEntityRef* entityRef2,
Boolean ignoreArea);
entityRef1 On input, a pointer to a value of type CfgEntityRef (page 99) for
one of the entity references that is to be compared.
entityRef2 On input, a pointer to a value of type CfgEntityRef (page 99) for
the second entity reference that is to be compared.
ignoreArea On input, a Boolean value. If ignoreArea is kCfgIgnoreArea ,
OTCfgIsSameEntityRef ignores the area ID when comparing
entityRef1 and entityRef2 . If ignoreArea is kCfgDontIgnoreArea ,
OTCfgIsSameEntityRef does not ignore the area ID when
comparing entityRef1 and entityRef2 .
function result TRUE if the entity references represent the same entity; FALSE if
the entity references represent different entities.
DISCUSSION
The OTCfgIsSameEntityRef function determines whether two entity references
represent the same area. For a discussion of the circumstances in which calling
OTCfgIsSameEntityRef is particularly useful, see “Areas and Sets” (page 48).
OTCfgCreateEntity 3
Creates an entity in an area.
OSStatus OTCfgCreateEntity (CfgDatabaseRef dbRef,
CfgAreaID areaID,
CfgEntityInfo* entityInfo,
CfgEntityRef* entityRef);