Otcfggetentityname – Apple Network Setup User 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
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
that identifies the entity whose name is to be obtained. To obtain
the reference for an entity, call
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
.