TECGetDestinationTextEncodings
Returns the encoding specifications for all the destinationtext encodings to which the Text Encoding Converter can directlyconvert the specified source encoding.
Declaration
OSStatus TECGetDestinationTextEncodings(TextEncoding inputEncoding, TextEncoding destinationEncodings[], ItemCount maxDestinationEncodings, ItemCount *actualDestinationEncodings);Parameters
- inputEncoding:
The text encoding specification describing the source text.
- destinationEncodings:
On return, an array of specifications for the destination encodings to which the converter can directly convert the source encoding. You should use the 1571805 Teccountdestinationtextencodings function to determine how large an array to allocate.
- maxDestinationEncodings:
The maximum number of destination text encodings that the array can contain.
- actualDestinationEncodings:
On return, a pointer to the number of text encoding specifications in the destination encodings array.
Return Value
A resultcode. See Result Codes.
Discussion
This function ignores duplicate direct text encoding specifications.If you used the TECCountDestinationTextEncodings function to determine the size of the destinationEncodings[] array,the number of available encodings may be fewer than the number ofarray elements, because TECCountDestinationTextEncodings includesduplicates in its count.
You can display the names of these destination encodings tothe user.