Inside Macintosh: Open Transport /

Chapter 10 - AppleTalk Addressing / AppleTalk Addressing Reference

Functions

OTExtractNBPName

Extracts the name part of an NBP name from an NBP entity structure.

C INTERFACE

void OTExtractNBPName(const NBPEntity* nbpEntity, char* name);

C++ INTERFACES

None. C++ applications use the C interface to this function.

PARAMETERS

nbpEntity

A pointer to the NBP entity structure from which you wish to extract an address.

name

A pointer to the string buffer in which to store the name portion of an NBP name string that you wish to extract from the
NBP entity.

DESCRIPTION

The OTExtractNBPName function extracts the name part of an NBP name from the specified NBP entity structure and stores it into the string buffer specified by the name parameter. This function inserts a backslash (\) in front of any backslash, colon (:), or at-sign (@) it finds in an NBP name so that mapper functions can use a correctly formatted NBP name.

SEE ALSO

The NBP entity structure is described in the section "The NBP Entity Structure," beginning on page 10-20.

The NBP address structure is described in the section "The NBP Address Structure," beginning on page 10-17.

To store the name, type, and zone parts of an NBP name in an NBP entity structure, use the OTSetNBPName function (page 10-31), the OTSetNBPType function (page 10-32), and the OTSetNBPZone function (page 10-34), respectively.

To extract the type and zone parts of an NBP name in an NBP entity structure, use the OTExtractNBPType function (page 10-36) and the OTExtractNBPZone function (page 10-37), respectively.