Directory Number Messages (IM: Telephony)

Chapter 5 - Telephone Manager Messages / Telephone Manager Message Reference

Directory Number Messages
The following bit masks specify the messages that the Telephone Manager passes to your application for a given directory number activity. You also use these constants when you call TELDNMsgHand to specify which messages you want your message handler to receive.
When your directory number message handler receives a message, the hTELDN parameter is a handle to the directory number structure for the directory number that originated the message. The msg parameter is one of the following constants. The globals parameter is the value you specified when you called the TELDNMsgHand function to register the message handling routine. The other parameters vary in meaning according to the message type.
enum {
   telDNForwardMsg         = 0x00000001,
   telDNDNDMsg             = 0x00000002,
   telDNVoiceMailMsg       = 0x00000004,
   telDNSelectedMsg        = 0x00000008,
   telDNOtherMsg           = 0x80000000,
   telAllDNMsgs            = 0x0000000f
};
Constant descriptions

telDNForwardMsg
Your application receives this message when state of the call forward feature associated with a directory number has changed (that is, when the TELForwardSet function is used to set up call forwarding or the TELForwardClr function is used to clear call forwarding for a directory number). The mtype parameter is a constant that specifies the type of call forwarding that is active. The value parameter 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 receive in these parameters. The rmtDN parameter specifies the remote directory number to which the call is being forwarded. The rmtName parameter specifies the name of the party to whom the call is being forwarded. The rmtSubaddress parameter specifies the subaddress for the remote directory number, if any.
telDNDNDMsg
Your application receives this message when state of the Do Not Disturb feature of a directory number has changed (that is, when the TELDNDSet function is used to set up the Do Not Disturb feature and when the TELDNDClr function is used to clear the Do Not Disturb feature for a directory number). The mtype parameter is a constant that indicates the type of Do Not Disturb feature that is associated with the directory number. The value parameter 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 receive in these parameters. The rmtDN, rmtName, and rmtSubaddress parameters are not used.
telDNVoiceMailMsg
Your application receives this message when state of the voice messaging feature associated with a directory number has changed. The mtype parameter is not used and is set to 0. The value parameter is a constant that indicates whether there are voice mail messages waiting to be read. See "Voice Mail Messages" on page 5-30 for a description of the constants you can receive in this parameter. The rmtDN parameter specifies the directory number where the message originated (if available). The rmtName parameter specifies the name of the party who left the message (if available). The rmtSubaddress parameter specifies the subaddress for the directory number, if any.
telDNSelectedMsg
Your application receives this message when the selection state of a directory number has changed (that is, when the TELDNSelect function is used to select or deselect a directory number). The mtype parameter is not used and is set to 0. The value parameter 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 parameters are not used.
telDNOtherMsg
Your application receives this message when a telephone tool needs to send it some information about a directory number that cannot be provided by the other directory number messages. The values passed in the mtype and value parameters are defined by the telephone tool.
telALLDNMsgs
All terminal events except telDNOtherMsg.