Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Data Structures

Directory Number Message Parameter Block

Your telephone tool passes a pointer to a directory number message parameter block when passing messages about directory numbers. The directory number message parameter block is defined by the TELDNMsgPB data type.

struct TELDNMsgPB {
   short                   toolID;
   short                   tRef;
   short                   dnRef;
   long                    msg;
   short                   mtype;
   short                   value;
   StringPtr               rmtDN;
   StringPtr               rmtName;
   StringPtr               rmtSubaddress;
};
typedef struct TELDNMsgPB TELDNMsgPB;

Field Description

toolID

The tool ID of your telephone tool.

tRef

The reference number of a telephone terminal. Your telephone tool assigns this number when the terminal is opened. You should not change this number as long as the terminal is open.

dnRef

The reference number of a directory number. You should not change this number as long as the directory number is valid.

msg

The message your tool is sending to the Telephone Manager.

mtype

A message type. The value in this field varies according to the message specified in the msg field. See the description of each particular message for information about this field.

value

A message value. The value in this field varies according to the message specified in the msg field. See the description of each particular message for information about this field.

rmtDN

A pointer to a Pascal-style string that stores a remote directory number (for example, the directory number being called).

rmtName

A pointer to a Pascal-style string that stores the name associated with a remote directory number.

rmtSubaddress

A pointer to a Pascal-style string that stores the subaddress of the specified remote directory number, if any.