Inside Macintosh: Open Transport /

Chapter 4 - Mappers / Mappers Reference

Constants and Data Types

The TRegisterRequest Structure

You use the TRegisterRequest structure to specify the entity name you want to register using the OTRegisterName function (page 4-21) and, optionally, to specify its address.

The TRegisterRequest structure is defined by the TRegisterRequest data type.

struct TRegisterRequest
   {  TNetbufname;
      TNetbufaddr;
   };
   typedef struct TRegisterRequest TRegisterRequest;

Field descriptions

name

A TNetbuf structure that specifies the location and size of a buffer containing the entity name you want to register. You must allocate a buffer that contains the name, set the name.buf field to point to that buffer, and set the name.len field to the length of the name.

addr

A TNetbuf structure that specifies the location and size of a buffer containing the address associated with the entity whose name you want to register. You must allocate a buffer that contains the address, set the addr.buf field to point to that buffer, and set the addr.len field to the length of the address. The actual address with which the entity is associated is returned in the addr field of the TRegisterReply structure.

You can set the addr.len field to 0, in which case the underlying protocol, finds an appropriate address to associate with the newly registered entity name.