Inside Macintosh: Telephony /

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

Telephone Manager Initialization Functions / Localizing Configuration Strings

TELIntlToEnglish

Translates a foreign language configuration string into English.

pascal TELErr TELIntlToEnglish (
                     TELHandle hTEL,
                     Ptr inputPtr,
                     Ptr *outputPtr,
                     short language);

hTEL

A handle to the telephone record associated with the telephone tool.

inputPtr

On entry, a pointer to a foreign C-style configuration string to be translated into English.

outputPtr

On exit, a pointer to the English C-style configuration string used for the translation.

language

A language code that identifies the language of the configuration string to be translated. See Inside Macintosh: Text for a complete list of the supported language codes.

function result

A result code. If the specified language is not supported, noErr is returned and outputPtr is set to nil. This function returns an operating-system error code if any internal errors occur.

DESCRIPTION

The TELIntlToEnglish function returns, in the outputPtr parameter, an English language version of the configuration string passed in the inputPtr parameter, which is in the language specified by the language parameter. The telephone tool associated with the telephone record specified by the hTEL parameter allocates space for outputPtr.

Note

You are responsible for disposing of the pointer after the translation.