IWMPMedia::getAttributeName 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.]

The getAttributeName method returns the name of the attribute corresponding to the specified index.

Syntax

public System.String getAttributeName(
  System.Int32 lIndex
);

Public Function getAttributeName( _
  ByVal lIndex As System.Int32 _
) As System.String
Implements IWMPMedia.getAttributeName

Parameters

lIndex [in]

A System.Int32 that is the index.

Return value

A System.String that is the attribute name.

Remarks

The attribute name returned can be used in conjunction with getItemInfo to retrieve the value for a specific named attribute.

Before calling this method, you must have read access to the library. For more information, see Library Access.

For information about the attributes supported by Windows Media Player, see the Attribute Reference.

Examples

The following example uses getAttributeName to fill a multi-line text box with the index and name of each attribute for the current media item. The AxWMPLib.AxWindowsMediaPlayer object is represented by the variable named player.

// Store an IWMPMedia3 interface for the current media item. 
WMPLib.IWMPMedia3 cm = (WMPLib.IWMPMedia3)player.currentMedia;

// Get the number of attributes for the current media item. 
int attCount = cm.attributeCount;

// Create an array of strings to hold the index and name for each attribute.
string[] attInfo = new string[attCount];

// Loop through the attribute list.
for (int i = 0; i < attCount; i++)
{
    // Store the attribute index and name in the array.
    attInfo[i] = ("Attribute " + i + ": " + cm.getAttributeName(i));
}

// Display the attribute information in the text box.
attributeNames.Lines = attInfo;

' Store an IWMPMedia3 interface for the current media item. 
Dim cm As WMPLib.IWMPMedia3 = player.currentMedia

' Get the number of attributes for the current media. 
Dim attCount As Integer = cm.attributeCount

' Create an array of strings to hold the index and name for each attribute.
Dim attInfo(attCount) As String

' Loop through the attribute list.
For i As Integer = 0 To (attCount - 1)

    ' Store the attribute index and name in the array.
    attInfo(i) = ("Attribute " + i.ToString() + ": " + cm.getAttributeName(i))

Next i

' Display the attribute information in the text box.
attributeNames.Lines = attInfo

Requirements

Requirement	Value
Version	Windows Media Player 9 Series or later
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

See also

IWMPMedia Interface (VB and C#)

IWMPMedia.getItemInfo (VB and C#)