Inside Macintosh: Telephony /

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

Telephone Manager Initialization Functions / Localizing Configuration Strings

TELEnglishToIntl

Converts an English configuration string into some other language.

pascal TELErr TELEnglishToIntl (
                     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 the English C-style configuration string to be translated into a foreign language.

outputPtr

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

language

A language code that identifies the language that the configuration string is being translated into. 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. See "Result Codes" on page 1-58 for a list of other result codes that the Telephone Manager may return. This function returns an operating-system error code if any internal errors occur.

DESCRIPTION

The TELEnglishToIntl function returns, in the outputPtr parameter, a version of the configuration string passed in the inputPtr parameter that 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.