Legacy Document

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

Chapter 24 - 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 and, optionally, to specify its address.

The TRegisterRequest structure is defined by the TRegisterRequest data type.

struct TRegisterRequest
{  
   TNetbufname;
   TNetbufaddr;
   OTFlags flags;
};
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 buffer.

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 buffer. 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.

flags

A field used to control registration. Normally, this field is set to 0 for default registration behavior. See the documentation for the naming service you are using for more information.