Carbon


TECGetDirectTextEncodingConversions

Header: TextEncodingConverter.h Carbon status: Supported

Returns the types of direct conversions currently configured in the Text Encoding Converter.

OSStatus TECGetDirectTextEncodingConversions (
    TECConversionInfo availableConversions[], 
    ItemCount maxAvailableConversions, 
    ItemCount *actualAvailableConversions
);
Parameter descriptions
availableConversions

An array composed of text encoding conversion information structures, each of which specifies a set of source and destination encodings for a type of conversion. See TECConversionInfo for more information. You should use the TECGetDirectTextEncodingConversions function to determine how large to make the array.

maxAvailableConversions

The maximum number of text encoding conversion information structures that the directConversions array can contain.

actualAvailableConversions

On return, a pointer to the number of text encoding conversion information structures returned in the directConversions array.

function result

A result code.

DISCUSSION

This function ignores duplicate text encoding conversion information structures. If you used the TECCountDirectTextEncodingConversions function to determine the size of the directConversions[] array, the number of text encoding conversion information structures may be fewer than the number of array elements, because TECCountDirectTextEncodingConversions counts duplicate text encoding conversion information structures.

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)