Skip to main content
IWMLanguageList interface

The IWMLanguageList interface manages a list of languages supported by an ASF file. This interface supports both content and metadata in multiple languages.

The IWMLanguageList interface is supported in the profile, writer, metadata editor, reader, and synchronous reader objects. A pointer to an instance of IWMLanguageList can be obtained by calling the QueryInterface method of any interface in one of the listed objects.

Important  Do not use this interface before opening the reader object.
 

Members

The IWMLanguageList interface inherits from the IUnknown interface. IWMLanguageList also has these types of members:

Methods

The IWMLanguageList interface has these methods.

MethodDescription
AddLanguageByRFC1766String

Adds an entry to the list of supported languages for a file based upon a language tag compliant with RFC 1766.

GetLanguageCount

Retrieves the total number of supported languages in the language list.

GetLanguageDetails

Retrieves the locale identifier (LCID) and RFC 1766-compliant tag for an entry in the list of supported languages.

 

For information about which interfaces can be obtained by using the QueryInterface method of this interface, see the topic for the object on which this interface is implemented.

Remarks

This interface provides support for referencing languages by a string compliant with RFC 1766 – Tags for the Identification of Languages. Other interfaces in this SDK refer to the languages supported in an ASF file by language index. A language index is assigned to every language added to the language list.

This interface manages the list of languages supported for the file. Individual features of the file may not support all of the languages in the list. When selecting a language for playback of an output associated with a set of streams that are mutually exclusive by language, you must get the languages that are supported in that mutual exclusion object. You can retrieve the languages supported for a particular output by using the methods of the IWMReaderAdvanced4 interface.

When using this interface to add metadata in multiple languages to an MP3 file, only the first half of the language string is important. For example, the RFC 1766 identifier "en-us" designates English in the region of the United States. When written to an MP3 file, the identifier would be "en" without a regional designation.

For a list of common RFC 1766-compliant language identifiers, see Language Strings.

See also

Interfaces
Metadata Editor Object
Profile Object
Reader Object
Synchronous Reader Object
Writer Object