Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Tool-Defined Functions /

MyVSCR

Called to handle scripting language interface operations.

pascal long MyVSCR (
                     TELHandle hTEL, 
                     short msg, 
                     long p1, 
                     long p2, 
                     long p3);

hTEL

A handle to a telephone record for the user's terminal.

msg

A constant that identifies the type of message being sent to the telephone tool. See "Scripting Language Interface Code Resource Messages," beginning on page 6-43 for a complete description of the available messages for a scripting language interface code resource.

p1

The first parameter for the specified message.

p2

The second parameter for the specified message.

p3

The third parameter for the specified message.

function result

A result code. See the description below for specific codes you can return.

DESCRIPTION

The MyVSCR function is the entry point to the scripting language interface code resource of a telephone tool. It should inspect the message specified by the msg parameter and respond accordingly. Currently, a scripting language interface code resource should accept these two messages:

enum {
   telMgetMsg              = 0,
   telMsetMsg              = 1
};

The meaning of the parameters p1, p2, and p3 is dependent on the message type specified by the msg parameter. See the descriptions of the scripting language interface code resource messages beginning on page 6-40 for information about these parameters for each message.

Your MyVSCR function should return, as its function result, a result code indicating the outcome of the request. You can return an operating-system result code or a Telephone Manager result code. If your function receives any message other than the two listed above, it should return the code telNotSupported.