Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Constants

Validation Code Resource Messages

A telephone tool's validation code resource must be able to handle two messages.

enum {
   telValidateMsg          = 0,
   telDefaultMsg           = 1
};

Constant descriptions

telValidateMsg

Your tool receives this message when an application requests that the Telephone Manager validate the fields of a telephone record. In response to this message, your tool should compare the fields in the telephone record specified by the hTEL parameter with values maintained by the tool. When done, your tool should return 0 if the request was handled, or 1 if the configuration record was rebuilt by your tool. Parameters p1, p2, and p3 are unused.

telDefaultMsg

Your tool receives this message when an application requests that the Telephone Manager fill in the fields of a telephone record with default values. In response to this message, your tool should fill in the telephone record specified by the hTEL parameter with default values maintained by the tool. On entry, parameter p2 contains 1 if your tool should allocate a new configuration record and return its address in the p1 parameter, or 0 if your tool should simply use the configuration record passed in the p1 parameter. Parameter p3 is unused.