Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

PATH Mac OS 8 and 9 Developer Documentation > Text Encoding Conversion Manager

Programming With the Text Encoding Conversion Manager

TECSetBasicOptions

Sets standard options that can be checked by the Text Encoding Converter plug-in components.

pascal OSStatus TECSetBasicOptions( TECObjectRef encodingConverter, OptionBits controlFlags);

encodingConverter: The reference to the text encoding converter object for which the options will be specified.This can be a reference returned by the function TECCreateConverter or TECCreateConverterFromPath.
controlFlags: Control flags that apply to the conversion performed by plugins. Currently you can use the following bitmasks to set flags that affect the Unicode plug-in: kUnicodeForceASCIIRangeMask and kUnicodeNoHalfwidthCharsMask. See Conversion Control Flags for more information.
function return: The function returns paramErr if invalid options are specified, and kTECCorruptConverterErr if encodingConverter specifies an invalid converter object.

DISCUSSION

This function allows you to specify options in a converter object that can be checked by all plug-ins invoked by that converter object. Currently, only the Unicode plug-in (which calls the Unicode Converter) checks these options. The available options are a subset of the options available for the Unicode Converter conversion functions.

VERSION NOTES

Introduced with Text Encoding Conversion Manager 1.5.