Carbon


ChangeTextToUnicodeInfo

Header: UnicodeConverter.h Carbon status: Supported

Changes the mapping information for the specified Unicode converter object used to convert text to Unicode to the new mapping you provide.

OSStatus ChangeTextToUnicodeInfo (
    TextToUnicodeInfo ioTextToUnicodeInfo, 
    ConstUnicodeMappingPtr iUnicodeMapping
);
Parameter descriptions
ioTextToUnicodeInfo

The Unicode converter object of type TextToUnicodeInfo containing the mapping to be modified. You use the function CreateTextToUnicodeInfo to obtain one.

iUnicodeMapping

A structure of type UnicodeMapping identifying the new mapping to be used. This is the mapping that replaces the existing mapping in the Unicode converter object.

function result

A result code.

DISCUSSION

The function replaces the mapping table information that currently exists in the Unicode converter object pointed to by the ioTextToUnicodeInfo parameter with the information contained in the UnicodeMapping structure you supply as the iUnicodeMapping parameter.

ChangeTextToUnicodeInfo resets the Unicode converter object’s fields as necessary.

If an error is returned, the Unicode converter object is invalid.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)