Legacy Document

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

Chapter 26 - Ports Reference / Functions

Registering as a Client /

OTRegisterAsClient

Registers your application as a client of Open Transport and gives Open Transport a notifier function it can use to send you events.

C INTERFACE

OSStatus OTRegisterAsClient(OTClientName name, 
                                          OTNotifyProcPtr proc)

C++ INTERFACE

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

PARAMETERS

name

A pointer to the user-readable name you want Open Transport to use for your application.

proc

A pointer to the notifier function you want Open Transport to use for sending events to your application.

function result

An error code. See Appendix B for more information.

DISCUSSION

The OTRegisterAsClient function registers your application as an Open Transport client. This function provides Open Transport with a pointer to your notifier function that it can call when port transition events occur. It also provides a user-readable name Open Transport can use when it delivers messages about these events to the user. This function is optional; if you do not want to receive these events, you do not have to call this function.

To unregister yourself as an Open Transport client, use the OTUnregisterAsClient function.

SEE ALSO

"Registering as an Open Transport Client".