Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Data Structures

Call Appearance Transfer Message Parameter Block

Your telephone tool passes a pointer to a call appearance transfer message parameter block when transferring calls. The call appearance transfer message parameter block is defined by the TELCATransfMsgPB data type.

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

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.

caRef

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

msg

The message your tool is sending to the Telephone Manager. In this case, the message should be telCATransferMsg.

mtype

A message type. For the telCATransferMsg message, this field is unused and should be set to 0.

value

A message value. For the telCATransferMsg message, this field contains the outcome of the transfer activity. See "Transfer Constants" on page 5-42 for a description of the values this field can contain.

rmtDN

A pointer to a Pascal-style string that stores the remote directory number to which the call is to be transferred.

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.

dialType

A value that specifies the type of directory number and name contained in the rmtDN and rmtName fields. See "Dial Types" on page 4-14 for a description of the available dial types.