Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Constants

Directory Number Messages

This section describes the messages that a telephone tool can send to the Telephone Manager's directory number master message handler. These messages are relayed to any applications that have installed a directory number message handler. For all directory number messages, your tool passes the message type and any necessary additional information in the fields of a directory number message parameter block (page 6-62).

Note

See "Directory Number Messages," beginning on page 5-12 for a description of how the directory number message type and additional information are passed to applications.

enum {
   telDNForwardMsg         = 0x00000001,
   telDNDNDMsg             = 0x00000002,
   telDNVoiceMailMsg       = 0x00000004,
   telDNSelectedMsg        = 0x00000008,
   telDNOtherMsg           = 0x80000000
};

Constant descriptions

telDNForwardMsg

Your tool sends this message when state of the call forward feature associated with a directory number has changed (that is, when the application calls the TELForwardSet function to set up call forwarding or the TELForwardClr function to clear call forwarding for a directory number). The mtype field is a constant that specifies the type of call forwarding that is active. The value field is a constant that indicates the state of the call forward activity. See "Call Forward Types and States" on page 5-28 for a description of the constants you can pass in these fields. The rmtDN field specifies the remote directory number to which the call is being forwarded. The rmtName field specifies the name of the party to whom the call is being forwarded. The rmtSubaddress field specifies the subaddress for the remote directory number, if any.

telDNDNDMsg

Your tool sends this message when state of the Do Not Disturb feature of a directory number has changed (that is, when the application calls the TELDNDSet function to set up the Do Not Disturb feature or the TELDNDClr function to clear the Do Not Disturb feature for a directory number). The mtype field is a constant that indicates the type of Do Not Disturb feature that is associated with the directory number. The value field is a constant that indicates the state of the Do Not Disturb feature. See "Do Not Disturb States" on page 5-29 for a description of the constants you can pass in these fields. The rmtDN, rmtName, and rmtSubaddress fields are unused and should be set to 0.

telDNVoiceMailMsg

Your tool sends this message when state of the voice messaging feature associated with a directory number has changed. The mtype field is not used and should be set to 0. The value field is a constant that indicates whether there are voice mail messages waiting to be read. See "Voice Mail Messages" on page 5-29 for a description of the constants you can pass in this field. The rmtDN field specifies the directory number where the message originated (if available). The rmtName field specifies the name of the party who left the message (if available). The rmtSubaddress field specifies the subaddress for the directory number, if any. If any of these items are unavailable, your tool should set the corresponding field to 0.

telDNSelectedMsg

Your tool sends this message when the selection state of a directory number has changed (that is, when the application called TELDNSelect function to select or deselect a directory number). The mtype field is not used and should be set to 0. The value field is a constant that indicates whether the directory number is selected. The possible values for this constant are described in "Directory Number Selection States" on page 5-30. The rmtDN, rmtName, and rmtSubaddress fields are unused and should be set to 0.

telDNOtherMsg

Your tool sends this message when it needs to send an application some information about a directory number that cannot be provided by the other directory number messages. The values passed in the mtype and value fields are defined by your telephone tool. You should fully describe the supported values in the documentation for your tool.