Inside Macintosh: Open Transport /

Chapter 4 - Mappers / Mappers Reference

Functions / Registering and Deleting Names

OTDeleteNameByID

Removes a previously registered name as specified by its name ID.

C INTERFACE

OSErr OTDeleteNameByID (MapperRef ref, OTNameID id);

C++ INTERFACES

TMapper::DeleteName(OTNameID id);

PARAMETERS

ref

A mapper reference.

id

The name ID, a long specifying a number that identifies the registered 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 OTDeleteNameByID function to delete a registered name.

If the mapper is in asynchronous mode, the OTDeleteNameByID function returns immediately. When the function completes execution, the mapper provider calls the notifier function, passing T_DELNAMECOMPLETE for the code parameter, and a pointer to the id parameter in the cookie parameter.

SEE ALSO

The name ID that you delete using the OTDeleteNameByID function is returned in the reply parameter to the OTRegisterName function (page 4-21).

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