Legacy Document

Inside Macintosh: Networking With Open Transport / Part 2 - Open Transport Reference

Chapter 30 - AppleTalk Reference / AppleTalk Addressing Reference

AppleTalk Utility Functions /

OTExtractNBPZone

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

C INTERFACE

void OTExtractNBPZone(const NBPEntity* entity, 
                     char* zone);

C++ INTERFACE

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

PARAMETERS

entity

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

zone

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

DISCUSSION

The OTExtractNBPZone function extracts the zone part of an NBP name from the specified NBP entity structure and stores it into the string buffer specified by the zone parameter.

To store the name, type, and zone parts of an NBP name in an NBP entity structure, use the OTSetNBPName function, the OTSetNBPType function, and the OTSetNBPZone function, respectively.

To extract the name and type parts of an NBP name in an NBP entity structure, use the OTExtractNBPName function and the OTExtractNBPType function, respectively.

Note

If the name parameter passed to the function OTSetNBPName contains a backslash, the result in the name parameter passed to the function OTExtractNBPName will not be the same, because the backslash is stripped by the function OTSetNBPName and is not re-added by the function OTExtractNBPName.

SEE ALSO

"The NBP Address Structure".