Legacy Document

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

Chapter 30 - AppleTalk Reference / AppleTalk Addressing Reference

AppleTalk Utility Functions /

OTSetNBPName

Set the name part of an NBP entity structure.

C INTERFACE

Boolean OTSetNBPName(NBPEntity* entity, 
                     const char* name);

C++ INTERFACE

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

PARAMETERS

nbpEntity

A pointer to the NBP entity structure in which you wish to set the name.

name

A pointer to the name portion of an NBP name string that you wish to store. Special characters must be quoted.

function result

See Discussion.

DISCUSSION

The OTSetNBPName function stores the NBP name specified by the name parameter into the NBP entity structure indicated by the entity parameter, deleting any previous name stored there. This function returns false if the name parameter is longer than the maximum allowed for a name part of an NBP name (32 characters).

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

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

SPECIAL CONSIDERATIONS

Backslashes in front of special characters will be removed. The function OTSetAddressFromNBPEntity will automatically insert them for mapper calls.

SEE ALSO

"The NBP Address Structure".