Apple Network Setup - Manual (Page 80)

C H A P T E R 3
Network Setup Reference
80 Network Setup Functions
function result A value of noErr indicates that OTCfgGetEntityLogicalName
returned successfully. For a list of other possible result codes,
see “Result Codes” (page 110).
DISCUSSION
The OTCfgGetEntityLogicalName function obtains the user-visible name of the
entity represented by entityRef .
Note
The OTCfgGetEntityLogicalName function is available in
Network Setup 1.2 and later. If
OTCfgGetEntityLogicalName is not available, you can get
the user-visible name of an entity by calling
OTCfgGetPrefs
(page 86) and specifying kOTCfgUserVisibleNamePref as the
preference to get. ◆
OTCfgGetEntityName 3
Obtains the name of an entity.
void OTCfgGetEntityName (const CfgEntityRef *entityRef,
Str255 entityName);
entityRef On input, a pointer to a value of type CfgEntityRef (page 99)
that identifies the entity whose name is to be obtained. To obtain
the reference for an entity, call
OTCfgGetEntitiesList (page 74).
entityName On input, a value of type Str255 . On output, entityName contains
the name of the entity represented by entityRef .
function result None.
DISCUSSION
The OTCfgGetEntityName function obtains the name of the entity represented by
entityRef .