Legacy Document

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

Chapter 30 - AppleTalk Reference / AppleTalk Addressing Reference

AppleTalk Utility Functions /

OTSetNBPType

Set the type part of an NBP entity structure.

C INTERFACE

Boolean OTSetNBPType(NBPEntity* entity,
                     const char* typeVal);

C++ INTERFACE

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

PARAMETERS

entity

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

type

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

function result

The function returns false if the type parameter is longer than the maximum allowed for type part of an NBP name (32 characters).

DISCUSSION

The OTSetNBPType function stores the NBP type specified by the typeVal parameter into the NBP entity structure indicated by the entity parameter, deleting any previous type stored there. To store the name and zone parts of an NBP name in an NBP entity structure, use the OTSetNBPName function A HREF=NetworkingWOT-434.html#MARKER-9-79> 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".