Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions / Creating, Initializing, and Validating a Telephone Record

TELValidate

Checks the fields in the telephone record to determine if the values conform with the capabilities of the telephone tool.

pascal Boolean TELValidate (TELHandle hTEL);

hTEL

A handle to a telephone record for a telephone tool.

function result

A Boolean value that indicates whether the current telephone record settings are valid for a given telephone tool. If the settings are valid, TELValidate returns false and the configuration fields are unchanged. However, if the validation fails, and TELValidate returns true, the telephone tool calls TELDefault to fill in the configuration record with the default values.

DESCRIPTION

The Telephone Manager calls the TELValidate function when it creates a new record (in response to a call to TELNew or TELNewWithResult) and when a telephone tool is configured. You can also call this function after restoring a saved configuration to verify that the telephone record contains valid settings for a telephone tool.