Inside Macintosh: Open Transport /

Chapter 4 - Mappers / Mappers Reference

Functions / Registering and Deleting Names

OTDeleteName

Removes a previously registered entity name.

C INTERFACE

OSErr OTDeleteName (MapperRef ref, TNetbuf* name);

C++ INTERFACES

TMapper::DeleteName(TNetbuf* name);

PARAMETERS

ref

The mapper reference of the mapper you are using to delete
the name.

name

A TNetbuf structure describing the name to be removed. You must allocate a buffer that contains the name, set the name.buf field to point to the buffer, and set the name.len field to the length of the name.

DESCRIPTION

If the name-registration protocol defined using the config parameter to the OTOpenMapper or OTAsyncOpenMapper function supports dynamic name and address registration, you can use the OTDeleteName function to delete a registered name.

COMPLETION EVENT CODES

T_DELNAMECOMPLETE

0x2000000E

The OTDeleteName function has completed. The cookie parameter of the notifier function points to the name parameter.

SEE ALSO

The OTRegisterName function you used to register the name returns an ID value for the registered name in its reply parameter. You might find it more convenient to use the OTDeleteNameByID function (described next) to delete a name using this ID value than to use the OTDeleteName function.

For information on how to use this function with a TCP/IP protocol, see page 8-20 in the TCP/IP chapter.

You use the OTOpenMapper function (page 4-19) or OTAsyncOpenMapper function (page 4-16) to create a mapper.