Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Constants

Scripting Language Interface Code Resource Messages

A telephone tool's scripting language interface code resource must be able to handle two messages.

enum {
   telMgetMsg              = 0,
   telMsetMsg              = 1
};

Constant descriptions

telMgetMsg

Your tool receives this message when an application calls TELGetConfig to get a null-terminated string describing the configuration for your telephone tool. Your tool should respond by returning, as its function result, a string that fully describes the configuration of the specified telephone record. If the string could not be successfully constructed, your tool should return nil. Parameters p1, p2, and p3 are unused.

telMsetMsg

Your tool receives this message when an application calls TELSetConfig to set the configuration of your telephone tool. On entry, parameter p1 points to a null-terminated string containing a description of the desired configuration. Your tool should respond by installing that configuration and returning, as its function result, a result code. The result code should be 0 if the string was successfully parsed. The result code should be a number less than -1 if an operating-system error occurred while parsing the string and -1 itself if some other error occurred. The result code can also be a positive number to indicate the character position at which parsing was suspended.

The Telephone Manager automatically calls TELValidate after your tool has responded to telMsetMsg. Parameters p2 and p3 are unused.