iTunes COM Interface Changes

The iTunes COM interface was first released with iTunes 4.5, which included version 1.0 of the iTunes type library.

Use IiTunes::CheckVersion() with the major and minor version of the type library to determine if the version of iTunes currently installed supports the interface you need.

Version 1.12 Changes

iTunes 8.1 included version 1.12 of the iTunes type library.

The IITFileOrCDTrack::Location() property can now be set (it was previously read-only).
Added IITFileOrCDTrack::ReleaseDate() read-only property.

Version 1.11 Changes

iTunes 7.7 included version 1.11 of the iTunes type library.

Version 1.10 Changes

iTunes 7.4 included version 1.10 of the iTunes type library.

IITUserPlaylist

Added IITUserPlaylist::Reveal() method.

IITAudioCDPlaylist

Added IITAudioCDPlaylist::Reveal() method.

IITFileOrCDTrack

Added IITFileOrCDTrack::Reveal() method.
Added IITFileOrCDTrack::AlbumRating(), IITFileOrCDTrack::AlbumRatingKind(), and IITFileOrCDTrack::RatingKind() properties.

IITURLTrack

Added IITURLTrack::Reveal() method.
Added IITURLTrack::AlbumRating(), IITURLTrack::AlbumRatingKind(), and IITURLTrack::RatingKind() properties.

Version 1.9 Changes

iTunes 7.1 included version 1.9 of the iTunes type library.

IITFileOrCDTrack

Added IITFileOrCDTrack::Unplayed() property.
Added IITFileOrCDTrack::Size64High() and IITFileOrCDTrack::Size64Low() properties.
Added IITFileOrCDTrack::SortAlbum(), IITFileOrCDTrack::SortAlbumArtist(), IITFileOrCDTrack::SortArtist(), IITFileOrCDTrack::SortComposer(), IITFileOrCDTrack::SortName(), and IITFileOrCDTrack::SortShow() properties.

Version 1.8 Changes

iTunes 7.0 included version 1.8 of the iTunes type library.

IiTunes

Added IiTunes::LibraryXMLPath() property.

IITArtwork

Added IITArtwork::IsDownloadedArtwork() property.

IITFileOrCDTrack

Added IITFileOrCDTrack::AlbumArtist() property.
Added IITFileOrCDTrack::PartOfGaplessAlbum() property.
Added IITFileOrCDTrack::SkippedCount() property.
Added IITFileOrCDTrack::SkippedDate() property.
Added IITFileOrCDTrack::VideoKind() property and ITVideoKind enumeration.
Added IITFileOrCDTrack::Show() property.
Added IITFileOrCDTrack::SeasonNumber() property.
Added IITFileOrCDTrack::EpisodeID() property.
Added IITFileOrCDTrack::EpisodeNumber() property.

IITUserPlaylist

Added ITUserPlaylistSpecialKindMusic, ITUserPlaylistSpecialKindMovies, ITUserPlaylistSpecialKindTVShows, and ITUserPlaylistSpecialKindAudiobooks to ITUserPlaylistSpecialKind enumeration.

Version 1.7 Changes

iTunes 6.0.2 included version 1.7 of the iTunes type library.

IiTunes

Added IiTunes::CreateFolder method.
Added IiTunes::CreateFolderInSource method.
Added IiTunes::SoundVolumeControlEnabled() property.

IITUserPlaylist

Added IITUserPlaylist::CreatePlaylist() method.
Added IITUserPlaylist::CreateFolder() method.
The IITUserPlaylist::Parent() property can now be written.

IITFileOrCDTrack

Added IITFileOrCDTrack::BookmarkTime() property.

Version 1.6 Changes

iTunes 6.0 included version 1.6 of the iTunes type library.

IITUserPlaylist

Added ITUserPlaylistSpecialKindVideos to ITUserPlaylistSpecialKind enumeration.

Version 1.5 Changes

iTunes 5.0 included version 1.5 of the iTunes type library.

iTunes Errors

Added ITUNES_E_PODCASTSDISABLED, which can be returned by IiTunes::SubscribeToPodcast().

IiTunes

Added IiTunes::UpdatePodcastFeeds() method.

IITFileOrCDTrack

Added IITFileOrCDTrack::UpdatePodcastFeed() method.
Added IITFileOrCDTrack::ExcludeFromShuffle() property.
Added IITFileOrCDTrack::Lyrics() property.
Added IITFileOrCDTrack::RememberBookmark() property.
Added IITFileOrCDTrack::Category() property.
Added IITFileOrCDTrack::Description() property.
Added IITFileOrCDTrack::LongDescription() property.

IITURLTrack

Added IITURLTrack::DownloadPodcastEpisode() method.
Added IITURLTrack::UpdatePodcastFeed() method.
Added IITURLTrack::Category() property.
Added IITURLTrack::Description() property.
Added IITURLTrack::LongDescription() property.

IITUserPlaylist

Added IITUserPlaylist::Parent() property.
Added ITUserPlaylistSpecialKindFolder to ITUserPlaylistSpecialKind enumeration.

Version 1.4 Changes

iTunes 4.9 included version 1.4 of the iTunes type library.

IiTunes

Added IiTunes::SubscribeToPodcast() method.

IITUserPlaylist

Added IITUserPlaylist::SpecialKind() property and ITUserPlaylistSpecialKind enumeration.

IITFileOrCDTrack

Added IITFileOrCDTrack::Podcast() property.

IITURLTrack

Added IITURLTrack::Podcast() property.

Version 1.3 Changes

iTunes 4.8 and 4.8.1 included version 1.3 of the iTunes type library.

IiTunes

Added IiTunes::ConvertOperationStatus() property.

IITIPodSource

Added IITIPodSource::SoftwareVersion() property.

_IITConvertOperationStatusEvents

Added _IITConvertOperationStatusEvents::OnConvertOperationCompleteEvent() outgoing event.

Version 1.2 Changes

iTunes 4.7 and 4.7.1 included version 1.2 of the iTunes type library.

iTunes Errors

Added ITUNES_E_OBJECTEXISTS, which can be returned by the new methods IiTunes::CreateEQPreset() and IITEQPreset::Rename().

_IiTunesEvents

Added _IiTunesEvents::OnAboutToPromptUserToQuitEvent() outgoing event.
Added _IiTunesEvents::OnSoundVolumeChangedEvent() outgoing event.

IiTunes

Added IiTunes::CreateEQPreset() method.
Added IiTunes::CreatePlaylistInSource() method.
Added IiTunes::GetPlayerButtonsState() method (and ITPlayButtonState enumeration).
Added IiTunes::PlayerButtonClicked() method (and ITPlayerButton and ITPlayerButtonModifierKey enumerations).
Added IiTunes::CanSetShuffle() property.
Added IiTunes::CanSetSongRepeat() property.
Changed the IiTunes::BackTrack(), IiTunes::PreviousTrack(), and IiTunes::NextTrack() methods to suppress the authorization dialog if invoking the method results in an attempt to start playing a purchased track that has not been authorized for playback on the current machine. The unauthorized track is skipped in this case.

IITEQPreset

Added IITEQPreset::Delete() and IITEQPreset::Rename() methods.
The IITEQPreset::Modifiable property always returns true for all EQ presets. Previously, only the Manual preset was modifiable. As a result of this change, setting the Preamp or Band properties can no longer return ITUNES_E_OBJECTLOCKED.

IITFileOrCDTrack

Added IITFileOrCDTrack::UpdateInfoFromFile() method.

IITIPodSource

Added IITIPodSource::EjectIPod() method.

IEnumVARIANT

Added IEnumVARIANT support to iTunes collection objects to allow clients to use enumeration semantics to iterate collections. For example, you can now use foreach in C#:

    IiTunes                 iTunes = new iTunesAppClass();
    IITPlaylistCollection   iPlaylists = iTunes.LibrarySource.Playlists;

    foreach (IITPlaylist iPlaylist in iPlaylists)
    {
        Console.WriteLine(iPlaylist.Name);
    }

You can also use For Each in VBScript:

    Set iTunesApp = WScript.CreateObject("iTunes.Application")

    Dim aPlaylist

    For Each aPlaylist In iTunesApp.LibrarySource.Playlists
        WScript.Echo(aPlaylist.Name)
    Next

Specifically, the following properties were added:

Version 1.1 Changes

iTunes 4.6 included version 1.1 of the iTunes type library.

IiTunes

Added IiTunes::AppCommandMessageProcessingEnabled property.
Added IiTunes::ForceToForegroundOnDialog property.
Added IiTunes::ConvertFile2(), IiTunes::ConvertFiles2(), IiTunes::ConvertTrack2(), and IiTunes::ConvertTracks2() methods which return an IITConvertOperationStatus. These methods supercede IiTunes::ConvertFile(), IiTunes::ConvertFiles(), IiTunes::ConvertTrack(), and IiTunes::ConvertTracks(), although the old methods are still available for backwards compatibility.

_IiTunesEvents

Added ITCOMDisabledReason enumeration.
Added _IiTunesEvents::OnCOMCallsDisabledEvent() and _IiTunesEvents::OnCOMCallsEnabledEvent() outgoing events.
Added _IiTunesEvents::OnQuittingEvent() outgoing event.

IITConvertOperationStatus

Added new interface IITConvertOperationStatus, which is returned by IiTunes::ConvertFile2(), IiTunes::ConvertFiles2(), IiTunes::ConvertTrack2(), and IiTunes::ConvertTracks2().

_IITConvertOperationStatusEvents

Added new _IITConvertOperationStatusEvents interface, which is supported by the IITConvertOperationStatus interface.