Carbon


TECGetAvailableSniffers

Header: TextEncodingConverter.h Carbon status: Supported

Returns the list of sniffers available in all installed plug-ins.

OSStatus TECGetAvailableSniffers (
    TextEncoding availableSniffers[], 
    ItemCount maxAvailableSniffers, 
    ItemCount *actualAvailableSniffers
);
Parameter descriptions
availableSniffers

On return, an array of text encoding specifications that the available sniffers currently support. You should use the TECCountAvailableSniffers function to determine what size array to allocate.

maxAvailableSniffers

The number of text encoding specifications the availableSniffers array can contain.

actualAvailableSniffers

On return, a pointer to the number of text encodings in the availableSniffers array.

function result

A result code.

DISCUSSION

This function ignores duplicate text encoding specifications. If you used the TECCountAvailableSniffers function to determine the size of the TECGetAvailableSniffers array, the number of available encodings may be fewer than the number of array elements, because TECCountAvailableSniffers includes duplicate text encoding specifications in its count.

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)