Share via


DownloadItem.getItemInfo method

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

This section describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

The getItemInfo method retrieves the value of an attribute for the download item.

Syntax

strRetVal = DownloadItem.getItemInfo(
  itemname
)

Parameters

itemname [in]

String containing the attribute name. Supported values are AlbumArtist, Album, Duration, WM/Provider, Title, UserRating, and WM/TrackNumber.

Return value

This method returns a String containing the value of the attribute specified by itemname.

Remarks

This method retrieves attributes specified using the BITS description string. See Windows Media Player BITS Job Convention.

This method is supported for background downloading. Your code should not call this method when using real-time downloading.

This method can retrieve information for BITS jobs added during the current Windows Media Player session only.

Requirements

Requirement Value
Version
Windows Media Player 10 or later
DLL
Wmp.dll

See also

DownloadItem.type

DownloadItem Object